Load Metadata from Microsoft Azure Data Catalog

Version:
2020.3
Last modified: September 01, 2020

Use the Microsoft Azure Data Catalog Loader to upload metadata to Alteryx Connect from a specified Microsoft Azure Data Catalog. You can upload metadata of glossary terms as well as data assets.

Review Loader Requirements

The Alteryx Connect Loaders must be installed on the machine where Alteryx Server is installed. To install the loaders:

  1. Download the loaders installer. For compatibility, the Loaders installer version must match the Alteryx Connect version.
  2. Run the installer as an administrator.

Review Microsoft Azure Data Catalog Requirements

Microsoft Azure Data Catalog apps are integrated with Microsoft Azure Active Directory to provide secure sign-in and authorization.

  1. Register your application with Microsoft Azure Active Directory using the Azure portal, designating your app as a Native app.
  2. Verify that you have an Application (Client) ID, Directory (Tenant) ID, username and password prepared for loader use.

Application Parameters Example

• Name: AzureDataCatalog

Application (Client) ID: f2c4a77f-fd3e-4bb2-935f-ed5a6e1ab4c8

• Directory (Tenant) ID: e4455234-407f-4ca8-b48c-c9b2c2ec77e4

• Redirect URIs: https://api.azuredatacatalog.com/

• Owners: Joe Smith

• Permissions: Microsoft Azure Data Catalog, Windows Azure Active Directory

Open the Loader

  1. Open Alteryx Designer.
  2. Select Help > Sample Workflows Alteryx Connect Metadata Loaders > Azure Data Catalog Loader > Azure Data Catalog Loader.

Run the App

  1. Select Run as Analytic App Run as analytic app button.
  2. In the Azure Data Catalog tab, select an application for the loader to use and enter the following:
    • Directory (Tenant) ID: The directory ID of your Native application for Azure Data Catalog. 
    • Application (Client) ID: The application ID of your Native application for Azure Data Catalog.
    • Redirect URL: Specify Redirect URL for the application.
    • Username & password: The credentials associated with the application.
  3. In the Alteryx Connect tab, type the URL for your Alteryx Connect instance and your credentials. 
    https://yourcompany.alteryxconnect.com

  4. Before running the app, select Save button and save the app configuration to the following directory: 
    C:\ProgramData\Alteryx\AlteryxConnect\AzureDataCatalog_Loader\

    The .yxwv app values file is used for scheduling the loader to run in the Gallery. See Schedule Metadata Loaders.

  5. Select Finish to run the app.
    • If the run succeeds, "Success" appears in the App Results window.
    • If the run fails, a "There were Errors" message appears.

    Depending on how much metadata is being imported, the app can take a long time to run.

View the Metadata

  1. Go to the Alteryx Connect URL and log in.
  2. From the main menu, select Data Sources > Databases.
  3. Select a folder to view its contents.
Was This Helpful?

Running into problems or issues with your Alteryx product? Visit the Alteryx Community or contact support.