[Ultimate]{class="badge positive"}
使用Flow Service API创建Azure Synapse Analytics基本连接
IMPORTANT
Azure Synapse Analytics源在源目录中可供已购买Real-time Customer Data Platform Ultimate的用户使用。
基本连接表示源和Adobe Experience Platform之间的已验证连接。
本教程将指导您完成使用Flow Service API为Azure Synapse Analytics（以下称为“Synapse”）创建基础连接的步骤。
快速入门
本指南要求您对 Adobe Experience Platform 的以下组件有一定了解：
以下部分提供使用Flow Service API成功连接到Synapse所需了解的其他信息。
收集所需的凭据
为了使Flow Service与Synapse连接，您必须提供以下连接属性的值：
凭据
描述
connectionString用于连接到Synapse的连接字符串。 Synapse连接字符串模式为
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连接规范返回源的连接器属性，包括与创建基础连接和源连接相关的验证规范。 Synapse的连接规范ID为：
a49bcc7d-8038-43af-b1e4-5a7a089a7d79有关获取连接字符串的详细信息，请参阅此Synapse文档。
使用平台API
有关如何成功调用平台API的信息，请参阅平台API快速入门指南。
创建基本连接
基本连接会保留您的源和平台之间的信息，包括源的身份验证凭据、连接的当前状态以及唯一的基本连接ID。 基本连接ID允许您浏览和浏览源中的文件，并标识要摄取的特定项目，包括有关其数据类型和格式的信息。
要创建基本连接ID，请在提供Synapse身份验证凭据作为POST参数的一部分时，向/connections端点请求请求。
API格式
POST /connections
请求
以下请求为Synapse创建基本连接：
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"
}
}'
参数
描述
auth.params.connectionString用于连接到Synapse的连接字符串。 Synapse连接字符串模式为
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.idSynapse连接规范ID为：
a49bcc7d-8038-43af-b1e4-5a7a089a7d79。响应
成功的响应返回新创建的连接的详细信息，包括其唯一标识符(id)。 在下个教程中，浏览您的数据库时需要此ID。
{
"id": "6bc13a3b-3546-455f-813a-3b3546a55fb1",
"etag": "\"3500866c-0000-0200-0000-5e83afa30000\""
}
后续步骤
通过完成本教程，您已使用Flow Service API创建了Synapse基本连接。 您可以在下列教程中使用此基本连接ID：
recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089