[Ultimate]{class="badge positive"}
Last update: Wed Jun 18 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
Azure Synapse Analytics來源可在來源目錄中提供給已購買Real-Time Customer Data Platform Ultimate的使用者。
閱讀本指南，瞭解如何使用Flow Service API將您的Azure Synapse Analytics帳戶連結至Adobe Experience Platform。
快速入門
本指南需要您深入瞭解下列Experience Platform元件：
- 來源： Experience Platform允許從各種來源擷取資料，同時讓您能夠使用Experience Platform服務來建構、加標籤以及增強傳入的資料。
- 沙箱： Experience Platform提供的虛擬沙箱可將單一Experience Platform執行個體分割成個別的虛擬環境，以利開發及改進數位體驗應用程式。
下列章節提供您需瞭解的其他資訊，才能使用Flow Service API成功連線到Azure Synapse Analytics。
收集必要的認證
閱讀Azure Synapse Analytics 總覽以取得驗證的相關資訊。
如需如何成功呼叫Experience Platform API的詳細資訊，請參閱Experience Platform API快速入門指南。
請閱讀下列內容，瞭解如何建立基本連線，並將您的Azure Synapse Analytics帳戶連線至Experience Platform。
建立基礎連線
基礎連線 儲存將來源系統連結至Adobe Experience Platform的金鑰資訊。 其中包括：
- 您來源的驗證認證
- 連線的目前狀態
- 唯一的 基底連線識別碼
基本連線ID 可讓您瀏覽和瀏覽來源中的檔案，協助您識別要擷取的專案，以及專案的資料型別和格式。
若要建立基底連線識別碼，請傳送POST要求至/connections端點，包括要求引數中的Azure Synapse Analytics驗證認證。
API格式
以連線字串為基礎的驗證
要求
下列要求會使用以連線字串為基礎的驗證，為Azure Synapse Analytics建立基礎連線。
| 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": "Connection for Azure Synapse Analytics",
"description": "Connection for Azure Synapse Analytics",
"auth": {
"specName": "Connection String Based Authentication",
"params": {
"connectionString": "Server=tcp:{SERVER_NAME}.database.windows.net,1433;Database={DATABASE};User ID={USERNAME}@{SERVER_NAME};Password={PASSWORD};Trusted_Connection=False;Encrypt=True;Connection Timeout=30"
}
},
"connectionSpec": {
"id": "a49bcc7d-8038-43af-b1e4-5a7a089a7d79",
"version": "1.0"
}
}'
|
| table 0-row-2 1-row-2 2-row-2 |
|
| 參數 |
說明 |
auth.params.connectionString |
用來連線到Azure Synapse Analytics的連線字串。 Azure Synapse Analytics連線字串模式為Server=tcp:{SERVER_NAME}.database.windows.net,1433;Database={DATABASE};User ID={USERNAME}@{SERVER_NAME};Password={PASSWORD};Trusted_Connection=False;Encrypt=True;Connection Timeout=30。 |
connectionSpec.id |
Azure Synapse Analytics連線規格識別碼為： a49bcc7d-8038-43af-b1e4-5a7a089a7d79。 |
|
回應
成功的回應會傳回新建立的基礎連線的詳細資料，包括其唯一識別碼(id)。
| accordion |
| 檢視範例回應 |
| code language-json |
{
"id": "6bc13a3b-3546-455f-813a-3b3546a55fb1",
"etag": "\"3500866c-0000-0200-0000-5e83afa30000\""
}
|
|
以服務主要金鑰為基礎的驗證
下列要求會使用以服務主要金鑰為基礎的驗證，為Azure Synapse Analytics建立基礎連線。
要求
| 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": "Connection for Azure Synapse Analytics",
"description": "Connection for Azure Synapse Analytics",
"auth": {
"specName": "Service Principal Key Based Authentication",
"params": {
"server": "yourworkspace.sql.azuresynapse.net",
"database": "SalesDW",
"tenant": "72f988bf-86f1-41af-91ab-2d7cd011db47",
"servicePrincipalId": "e7b8c1f2-1234-4c9a-9f3e-abcdef123456",
"servicePrincipalKey": "~XyZ1234abcDEF5678..."
}
},
"connectionSpec": {
"id": "a49bcc7d-8038-43af-b1e4-5a7a089a7d79",
"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.server |
Azure Synapse Analytics SQL端點的完整網域名稱。 |
auth.params.database |
Azure Synapse Analytics工作區中特定資料庫的名稱。 |
auth.params.tenant |
與您的Azure訂閱相關聯的Azure Active Directory租使用者識別碼。 |
auth.params.servicePrincipalId |
Azure Active Directory應用程式的使用者端識別碼。 |
auth.params.servicePrincipalKey |
與服務主體關聯的使用者端密碼或密碼。 |
connectSpec.id |
Azure Synapse Analytics的連線規格ID。 |
|
回應
成功的回應會傳回新建立的基礎連線的詳細資料，包括其唯一識別碼(id)。
| accordion |
| 檢視範例回應 |
| code language-json |
{
"id": "6bc13a3b-3546-455f-813a-3b3546a55fb1",
"etag": "\"3500866c-0000-0200-0000-5e83afa30000\""
}
|
|