[Ultimate]{class="badge positive"}

建立 Snowflake 基礎連線使用 Flow Service API

Last update: Mon Jan 29 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

undefined

IMPORTANT

此 Snowflake 已購買Real-time Customer Data Platform Ultimate的使用者可在來源目錄中取得來源。

基礎連線代表來源和Adobe Experience Platform之間的已驗證連線。

使用下列教學課程來瞭解如何為建立基本連線 Snowflake 使用 [Flow Service API] (https://www.adobe.io/experience-platform-apis/references/flow-service/).

快速入門

本指南需要您深入了解下列 Adobe Experience Platform 元件：

來源： Experience Platform 允許從各種來源擷取資料，同時讓您能夠使用以下專案來建構、加標籤及增強傳入資料 Platform 服務。
沙箱： Experience Platform 提供分割單一區域的虛擬沙箱 Platform 將執行個體整合至個別的虛擬環境中，協助開發及改進數位體驗應用程式。

使用平台API

如需如何成功呼叫Platform API的詳細資訊，請參閱以下指南： Platform API快速入門.

下節提供成功連線所需的其他資訊 Snowflake 使用 Flow Service API。

收集必要的認證

您必須提供下列認證屬性的值，才能驗證您的 Snowflake 來源。

帳戶金鑰驗證

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2
認證	說明
`account`	帳戶名稱可唯一識別組織內的帳戶。在此情況下，您必須唯一識別跨不同帳戶的身分 Snowflake 組織。若要這麼做，您必須在帳戶名稱前加上組織名稱。例如: `orgname-account_name`。如需帳戶名稱的詳細資訊，請參閱 Snowflake 檔案：帳戶識別碼.
`warehouse`	此 Snowflake warehouse會管理應用程式的查詢執行程式。每個 Snowflake Warehouse彼此獨立，將資料帶到Platform時必須個別存取。
`database`	此 Snowflake 資料庫包含您要帶入Platform的資料。
`username`	的使用者名稱 Snowflake 帳戶。
`password`	的密碼 Snowflake 使用者帳戶。
`role`	要使用的預設存取控制角色 Snowflake 工作階段。該角色應為已指派給指定使用者的現有角色。預設角色為 `PUBLIC`.
`connectionString`	用來連線至您的裝置的連線字串 Snowflake 執行個體。的連線字串模式 Snowflake 是 `jdbc:snowflake://{ACCOUNT_NAME}.snowflakecomputing.com/?user={USERNAME}&password={PASSWORD}&db={DATABASE}&warehouse={WAREHOUSE}`

金鑰組驗證

若要使用金鑰組驗證，您必須產生2048位元RSA金鑰組，然後在建立帳戶時提供下列值 Snowflake 來源。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
認證	說明
`account`	帳戶名稱可唯一識別組織內的帳戶。在此情況下，您必須唯一識別跨不同帳戶的身分 Snowflake 組織。若要這麼做，您必須在帳戶名稱前加上組織名稱。例如: `orgname-account_name`。如需帳戶名稱的詳細資訊，請參閱 Snowflake 檔案：帳戶識別碼.
`username`	您的使用者名稱 Snowflake 帳戶。
`privateKey`	此 Base64-您的加密私密金鑰 Snowflake 帳戶。您可以產生加密或未加密的私密金鑰。如果您使用加密的私密金鑰，則在針對Experience Platform進行驗證時，也必須提供私密金鑰複雜密碼。
`privateKeyPassphrase`	私密金鑰複雜密碼是附加的安全性層級，在使用加密的私密金鑰進行驗證時必須使用此層級。如果您使用未加密的私密金鑰，則不需要提供複雜密碼。
`database`	此 Snowflake 包含您要擷取以Experience Platform之資料的資料庫。
`warehouse`	此 Snowflake warehouse會管理應用程式的查詢執行程式。每個 Snowflake warehouse彼此獨立，在將資料帶到Experience Platform時必須個別存取。

如需這些值的詳細資訊，請參閱 Snowflake 金鑰組驗證指南.

NOTE

您必須設定 PREVENT_UNLOAD_TO_INLINE_URL 標幟到 FALSE 允許從解除安裝資料 Snowflake 要Experience Platform的資料庫

建立基礎連線

基礎連線會保留您的來源和平台之間的資訊，包括來源的驗證認證、連線的目前狀態，以及您唯一的基本連線ID。基礎連線ID可讓您從來源內部探索及導覽檔案，並識別您要擷取的特定專案，包括其資料型別和格式的資訊。

若要建立基本連線ID，請向以下連線ID發出POST請求： /connections 端點，同時提供 Snowflake 要求內文中的驗證認證。

API格式

POST /connections

ConnectionString

accordion

要求

下列要求會建立 Snowflake：

code language-shell

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "Snowflake base connection",
      "description": "Snowflake base connection",
      "auth": {
          "specName": "ConnectionString",
          "params": {
              "connectionString": "jdbc:snowflake://{ACCOUNT_NAME}.snowflakecomputing.com/?user={USERNAME}&password={PASSWORD}&db={DATABASE}&warehouse={WAREHOUSE}"
          }
      },
      "connectionSpec": {
          "id": "b2e08744-4f1a-40ce-af30-7abac3e23cf3",
          "version": "1.0"
      }
  }'

table 0-row-2 1-row-2 2-row-2
屬性	說明
`auth.params.connectionString`	用來連線至您的裝置的連線字串 Snowflake 執行個體。的連線字串模式 Snowflake 是 `jdbc:snowflake://{ACCOUNT_NAME}.snowflakecomputing.com/?user={USERNAME}&password={PASSWORD}&db={DATABASE}&warehouse={WAREHOUSE}`.
`connectionSpec.id`	此 Snowflake 連線規格ID： `b2e08744-4f1a-40ce-af30-7abac3e23cf3`.

accordion

回應

成功的回應會傳回新建立的連線，包括其唯一的連線識別碼(id)。在下個教學課程中探索您的資料時，需要此ID。

code language-json
`{ "id": "2fce94c1-9a93-4971-8e94-c19a93097129", "etag": "\"d403848a-0000-0200-0000-5e978f7b0000\"" }`

使用加密私密金鑰的金鑰組驗證

accordion

要求

code language-shell

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "Snowflake base connection with encrypted private key",
      "description": "Snowflake base connection with encrypted private key",
      "auth": {
        "specName": "KeyPair Authentication",
        "params": {
            "account": "acme-snowflake123",
            "username": "acme-cj123",
            "database": "ACME_DB",
            "privateKey": "{BASE_64_ENCODED_PRIVATE_KEY}",
            "privateKeyPassphrase": "abcd1234",
            "warehouse": "COMPUTE_WH"
        }
    },
    "connectionSpec": {
        "id": "b2e08744-4f1a-40ce-af30-7abac3e23cf3",
        "version": "1.0"
    }
  }'

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2
屬性	說明
`auth.params.account`	您的名稱 Snowflake 帳戶。
`auth.params.username`	與您的相關聯的使用者名稱 Snowflake 帳戶。
`auth.params.database`	此 Snowflake 從其中提取資料的資料庫。
`auth.params.privateKey`	此 Base64-已編碼您的加密私密金鑰 Snowflake 帳戶。
`auth.params.privateKeyPassphrase`	與您的私密金鑰對應的複雜密碼。
`auth.params.warehouse`	此 Snowflake 您正在使用的倉儲。
`connectionSpec.id`	此 Snowflake 連線規格ID： `b2e08744-4f1a-40ce-af30-7abac3e23cf3`.

accordion

回應

成功的回應會傳回新建立的連線，包括其唯一的連線識別碼(id)。在下個教學課程中探索您的資料時，需要此ID。

code language-json
`{ "id": "2fce94c1-9a93-4971-8e94-c19a93097129", "etag": "\"d403848a-0000-0200-0000-5e978f7b0000\"" }`

使用未加密私密金鑰的金鑰組驗證

accordion

要求

code language-shell

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "Snowflake base connection with encrypted private key",
      "description": "Snowflake base connection with encrypted private key",
      "auth": {
        "specName": "KeyPair Authentication",
        "params": {
            "account": "acme-snowflake123",
            "username": "acme-cj123",
            "database": "ACME_DB",
            "privateKey": "{BASE_64_ENCODED_PRIVATE_KEY}",
            "warehouse": "COMPUTE_WH"
        }
    },
    "connectionSpec": {
        "id": "b2e08744-4f1a-40ce-af30-7abac3e23cf3",
        "version": "1.0"
    }
  }'

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
屬性	說明
`auth.params.account`	您的名稱 Snowflake 帳戶。
`auth.params.username`	與您的相關聯的使用者名稱 Snowflake 帳戶。
`auth.params.database`	此 Snowflake 從其中提取資料的資料庫。
`auth.params.privateKey`	此 Base64-已編碼的未加密私密金鑰(您的 Snowflake 帳戶。
`auth.params.warehouse`	此 Snowflake 您正在使用的倉儲。
`connectionSpec.id`	此 Snowflake 連線規格ID： `b2e08744-4f1a-40ce-af30-7abac3e23cf3`.

accordion

回應

成功的回應會傳回新建立的連線，包括其唯一的連線識別碼(id)。在下個教學課程中探索您的資料時，需要此ID。

code language-json
`{ "id": "2fce94c1-9a93-4971-8e94-c19a93097129", "etag": "\"d403848a-0000-0200-0000-5e978f7b0000\"" }`

依照本教學課程，您已建立 Snowflake 基礎連線使用 Flow Service API。您可以在下列教學課程中使用此基本連線ID：

recommendation-more-help

337b99bb-92fb-42ae-b6b7-c7042161d089