Skip to content

:alation: Alation Migration Assistant

Mapping Template CSV file The Alation Migration Assistant helps migrate Alation articles into glossary terms in Atlan. It also supports creating an image mapping file by uploading a ZIP file of images. Images can be added to term descriptions either through the mapping file or directly using a ZIP folder if no mapping file is available.

Configuration

Source

  • Import metadata from: select how you want to provide the input file(s) to be processed.

    Retrieve the metadata files from cloud object storage.

    • Cloud object store the object store from which to fetch the metadata file(s).

      • AWS access key: your AWS access key.
      • AWS secret key: your AWS secret key.
      • Region: your AWS region.
      • Bucket: your AWS bucket.

      Reusing Atlan's backing S3 store

      When your Atlan tenant is deployed in AWS, you can leave all of these blank to reuse the backing store of Atlan itself. You can also set up a cross-account bucket policy for Atlan to have access to your S3 bucket and the objects within it, and leave these blank.

      • Project ID: the ID of your GCP project.
      • Servive account JSON: your service account credentials, as JSON.
      • Bucket your GCS bucket.

      Reusing Atlan's backing GCS store

      When your Atlan tenant is deployed in GCP, you can leave all of these blank to reuse the backing store of Atlan itself.

      • Azure client ID: the unique application (client) ID assigned to your app by Azure AD when the app was registered.
      • Azure client secret: your Azure client secret (it's actual value, not its identifier).
      • Azure tenant ID: the unique identifier of the Azure Active Directory instance.
      • Storage account name: name of your storage account.
      • Container: your ADLS container.

      Reusing Atlan's backing ADLS store

      When your Atlan tenant is deployed in Azure, you can leave all of these blank to reuse the backing store of Atlan itself.

Images

  • "Select 'YES' if you have a mapping CSV file; otherwise, select 'NO'. If you select 'YES', provide the mapping file details. If you select 'NO', provide the image zip file details. If you are supplying the mapping file, ensure it is in CSV format."
  • Prefix (path) the directory (path) within the object store from which to fetch the file containing zipfile or url mapping csv.
  • Object key (filename) the object key (filename), including its extension, within the object store and prefix.

Articles

  • Provide the Qualified Name of glossary you want to upload articles in.
  • Prefix (path) the directory (path) within the object store from which to fetch the file containing aricles csv.
  • Object key (filename) the object key (filename), including its extension, within the object store and prefix.

What it does

  • Accepts an image mapping file (CSV or ZIP) and an article CSV file as input.
  • If a ZIP file is provided, it converts the ZIP file into a mapping file.
  • Replaces all the Alation image URLs with Atlan image URLs.
  • Uploads the article to Atlan in the glossary provided by the user.
How it works

  1. Reading Files: It reads files (like articles and images) from cloud storage services such as Amazon S3, Google Cloud Storage, and Azure Data Lake Storage.

  2. Replacing Image Links: It updates the image links in the articles to ensure they point to the correct locations in the new system.

  3. Uploading Articles: After updating the image links, it uploads the revised articles to the target system.

  4. Execution: The program follows a series of steps to complete the process, starting with reading the cloud files, updating the content, and finally uploading the articles.

In essence, this program automates the process of transferring and updating content from one storage system to another, ensuring everything is correctly linked and organized.