Skip to main content
Administrator Guide
Last Updated: 2026-08-07
Set Up Zero-Copy Data In with Snowflake

Set Up Zero-Copy Data In with Snowflake

Prerequisites

Task 1: Create a Zero-Copy Connection to Snowflake

You can access Snowflake table metadata without copying data by creating a zero-copy connection from Workday to your Snowflake Iceberg catalog.
  1. In Workday, access the Prism Data Catalog report.
  2. Select
    + Create
    >
    Connection
    .
  3. In the
    Create Connection
    wizard, under
    Zero Copy Connectors
    , select the
    Snowflake
    tile.
  4. Enter the connection details:
    Field
    Description
    Name
    The connection name must be unique in the Data Catalog. Example:
    Snowflake_ZeroCopy_<first name><last initial>
    .
    Description
    (Optional) A brief description of the connection's purpose.
    Catalog URL
    The URL of the Snowflake data catalog. The URL must use only lowercase characters. Format:
    https://<account_locator>.snowflakecomputing.com/polaris/api/catalog
    Catalog Name
    The name of the Snowflake catalog that contains your Iceberg tables.
    Authentication Type
    Select
    Oauth 2.0 with Key Pair
    .
    Issuer
    Enter initial values. You'll retrieve the
    PUBLIC_KEY_FP
    value later in this procedure. Format:
    ACCOUNT_LOCATOR
    .
    SERVICE_USER
    .
    PUBLIC_KEY_FP
    Example:
    XTQ04827.ICEFLOW_PRISM_USER.<PUBLIC_KEY_FP>
    Principal
    The Service Principal from Snowflake. This user will be used to authenticate the Snowflake connection. Format:
    ACCOUNT_LOCATOR
    .
    SERVICE_USER
    Example:
    XTQ04827.ICEFLOW_PRISM_USER
    Token Endpoint
    The OAuth2 token endpoint from Snowflake. Format:
    Catalog_URL
    /v1/oauth/tokens Example:
    https://<account_locator>.snowflakecomputing.com/polaris/api/catalog/v1/oauth/tokens
    Scopes
    The OAuth2 scopes from Snowflake. The scopes define what the Principal has access to when connected to Snowflake.
  5. Save the connection but do
    not
    test it yet. Before you test the connection, you must complete the certificate/key setup in the subsequent steps.
    After the save is complete, the
    Authentication Certificate
    window displays.
  6. From the
    Authentication Certificate
    window, download the certificate in
    PKCS#8
    format.
    If you skipped downloading the certificate from the
    Authentication Certificate
    window, follow these steps:
    1. Access the
      Data Catalog
      report.
    2. From the
      Connections
      list, open the connection you just created. Example:
      Snowflake_ZeroCopy_<first name><last initial>
    3. On the
      View Connection Details
      page, locate the
      Authentication Certificate
      section.
    4. Click
      Certificate
      >
      Download
      .
    5. Select
      PKCS#8
      .
    This file contains the RSA public key that you'll register with the Snowflake service user.
  7. Set the RSA public key on the Snowflake service user.
    1. Sign in to your Snowflake account.
    2. Create a
      SQL Worksheet
      with sufficient privileges to alter the service user.
    3. Type and run an ALTER USER command to set the RSA public key for your service user.
      Example:
      ALTER USER ICEFLOW_PRISM_USER SET RSA_PUBLIC_KEY = '<Content of Downloaded PKCS#8>';
      If your environment uses a
      second RSA key
      , use RSA_PUBLIC_KEY_2 instead. Example:
      ALTER USER ICEFLOW_PRISM_USER SET RSA_PUBLIC_KEY_2 = '<Content of Downloaded PKCS#8>';
    4. Run the following command to inspect the user and retrieve the public key fingerprint:
      DESCRIBE USER ICEFLOW_PRISM_USER;
    5. In the result set, locate the value of either:
      • RSA_PUBLIC_KEY_FP
      • RSA_PUBLIC_KEY_2_FP (if you used the second key)
    6. Copy this fingerprint value.
  8. Update the Workday connection Issuer with the fingerprint value.
    1. In Workday, open your Snowflake zero-copy connection.
    2. From the related actions menu of the connection, select
      Prism Connection
      >
      Edit Connection
      .
    3. Update the
      Issuer
      field to append the RSA public key fingerprint.
      Use this final Issuer format:
      <ACCOUNT_LOCATOR>.<SERVICE_USER>.<PUBLIC_KEY_FP>
      Where:
      • ACCOUNT_LOCATOR
        is your Snowflake account locator.
      • SERVICE_USER
        is the service user you altered above.
      • PUBLIC_KEY_FP
        is the value copied from RSA_PUBLIC_KEY_FP (or RSA_PUBLIC_KEY_2_FP).
    4. Save the updated connection.
  9. Test the connection.
    1. On the
      Connection Details
      page, select
      Test Connection
      .
    2. If the test fails, verify:
      • Catalog URL format.
      • Token endpoint URL.
      • Service user and account locator values.
      • RSA public key is correctly set on the user.
      • Issuer format, including the public key fingerprint.

Task 2: Create an External Catalog

An external catalog acts as a virtual window into your external data, allowing you to browse tables in real-time.
  1. Access the
    Data Catalog
    report.
  2. Select
    + Create
    >
    External Catalog
    .
  3. Enter the external catalog details:
    Field
    Description
    External Catalog Name
    Enter a name for your external catalog.
    Connection
    Select the external partner zero-copy connection you just created.
    Namespace
    The exact namespace where the Iceberg connector tables reside. This information is provided by Snowflake. Example:
    enterprise.finance.procurement
    .
    Description
    (Optional) The description of the external catalog.
  4. Click
    Save
    .
  5. Wait for the
    Success
    notification that the External Catalog was created.
  6. Select
    Back to Data Catalog
    .
  7. Select
    External Catalog
    , and validate that schema sync is successful on your External Catalog.
After you save the External Catalog, Workday automatically runs a
Schema Sync
to:
  • Read the metadata of Iceberg tables in the specified Snowflake namespace.
  • Register those tables as
    External Tables
    in Workday.
  • Make table structures visible in the Data Catalog
    without moving or copying data
    .
The duration of this sync depends on the number and complexity of tables in the namespace.

Task 3: Explore and Validate External Tables

Explore the external tables registered from the external partner and perform basic schema validation inside Workday.
  1. Locate the external partner's external tables.
    1. Access the
      Data Catalog
      report.
    2. In the left-hand menu, select
      External Tables
      .
    3. Click on the
      Refresh
      button.
    4. In the
      External Tables
      view, confirm that all Iceberg tables from the external partner are listed under the schema/namespace you selected during external catalog creation.
  2. Inspect an external table.
    1. Right-click or double-click the table name to open
      View External Table Details
      .
    2. On the details page, review:
      • Column names
      • Data types
      • Any available column statistics
      • Sample data preview (if present)
  3. Verify that:
    • Data types (Example: Numeric vs. string) align with the definitions in the external system.
    • Values appear as expected.