[Ultimate]{class="badge positive"}

使用Flow Service API将AWS Redshift连接到Experience Platform

最近更新： 2026年10月3日

主题：
实施

创建对象：

开发人员

IMPORTANT

AWS Redshift源在源目录中可供已购买Real-Time Customer Data Platform Ultimate的用户使用。

阅读本指南，了解如何使用Flow Service API将您的AWS Redshift源帐户连接到Adobe Experience Platform。

快速入门

本指南要求您对 Adobe Experience Platform 的以下组件有一定了解：

源： Experience Platform允许从各种源摄取数据，同时允许您使用Experience Platform服务来构建、标记和增强传入数据。
沙盒： Experience Platform提供将单个Experience Platform实例划分为单独虚拟环境的虚拟沙盒，以帮助开发和改进数字体验应用程序。

使用Experience Platform API

有关如何成功调用Experience Platform API的信息，请参阅Experience Platform API快速入门指南。

将AWS Redshift连接到Azure上的Experience Platform azure

有关如何将AWS Redshift源连接到Azure上的Experience Platform的信息，请阅读以下步骤。

收集所需的凭据

提供连接Flow Service与AWS Redshift所需的连接属性。您还可以提供可选的table属性，以将您的连接限定在单个表中。

凭据

描述

server

AWS Redshift实例的服务器名称。

port

AWS Redshift服务器用于侦听客户端连接的TCP端口。

username

与您的AWS Redshift帐户关联的用户名。

password

与用户帐户对应的密码。

database

从中获取数据的AWS Redshift数据库。

table

可选。要将此连接作用域到的表。使用{SCHEMA}.{TABLE}，例如test_schema.my_table。只提供一个架构和一个表，以一个句点分隔。

connectionSpec.id

连接规范返回源的连接器属性，包括与创建基础连接和源连接相关的验证规范。 AWS Redshift的连接规范ID为3416976c-a9ca-4bba-901a-1f08f66978ff。

有关入门的详细信息，请参阅此AWS Redshift 文档。

在Azure [#azure-base]的Experience Platform上为AWS Redshift创建基础连接

NOTE

Redshift的默认编码标准为Unicode。无法更改此设置。

基本连接会保留源与Experience Platform之间的信息，包括源的身份验证凭据、连接的当前状态以及唯一的基本连接ID。基本连接ID允许您浏览和浏览源中的文件，并标识要摄取的特定项目，包括有关其数据类型和格式的信息。

要创建基本连接ID，请在提供您的AWS Redshift身份验证凭据作为请求参数的一部分时，向/connections端点发出POST请求。

要将连接范围设定为单个表，请在请求中包含auth.params.table。如果提供，根探索(GET /connections/{BASE_CONNECTION_ID}/explore?objectType=root)仅返回指定的表。省略auth.params.table以在根目录探索期间返回数据库中表的完整列表。

API格式

POST /connections

请求

选择以查看示例

以下请求为作用域为单个表的AWS Redshift创建基础连接：

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": "AWS-redshift base connection",
      "description": "base connection for AWS-redshift",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "server": "{SERVER}",
              "port": "{PORT}",
              "username": "{USERNAME}",
              "password": "{PASSWORD}",
              "database": "{DATABASE}",
              "table": "{SCHEMA}.{TABLE}"
          }
      },
      "connectionSpec": {
          "id": "3416976c-a9ca-4bba-901a-1f08f66978ff",
          "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.server`	AWS Redshift实例的服务器名称。
`auth.params.port`	AWS Redshift服务器用于侦听客户端连接的TCP端口。
`auth.params.username`	与您的AWS Redshift帐户关联的用户名。
`auth.params.password`	与用户帐户对应的密码。
`auth.params.database`	从中获取数据的AWS Redshift数据库。
`auth.params.table`	可选。要将此连接作用域到的表。使用`<schema>.<table>`，例如`test_schema.my_table`。只提供一个架构和一个表，以一个句点分隔。如果提供，根探索将仅返回指定的表。如果省略root exploration ，则会返回数据库中的所有表。
`connectionSpec.id`	AWS Redshift连接规范ID： `3416976c-a9ca-4bba-901a-1f08f66978ff`

响应

选择以查看示例

成功的响应返回新创建的连接，包括其唯一标识符(id)。在下个教程中，需要此ID才能浏览您的数据。

code language-json
`{ "id": "373e88fc-43da-4e3c-be88-fc43da3e3c0f", "etag": "\"1700ce7b-0000-0200-0000-5e3b405e0000\"" }`

将AWS Redshift连接到AWS Web服务(AWS)上的Experience Platform aws

AVAILABILITY

本节适用于在AWS Web Services (AWS)上运行的Experience Platform的实施。在AWS上运行的Experience Platform当前仅对有限数量的客户可用。要了解有关支持的Experience Platform基础架构的更多信息，请参阅Experience Platform multi-cloud概述。

有关如何将AWS Redshift源连接到AWS上的Experience Platform的信息，请阅读以下步骤。

在AWS上的Experience Platform上为AWS Redshift创建基本连接 aws-base

API格式

POST /connections

请求

以下请求为AWS Redshift创建基本连接：

选择以查看示例

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": "AWS Redshift base connection for Experience Platform on AWS",
      "description": "AWS Redshift base connection for Experience Platform on AWS",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "server": "{SERVER}",
              "port": "5439",
              "username": "{USERNAME}",
              "password": "{PASSWORD}",
              "database": "{DATABASE}",
              "schema": "{SCHEMA}"
          }
      },
      "connectionSpec": {
          "id": "3416976c-a9ca-4bba-901a-1f08f66978ff",
          "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.server`	AWS Redshift实例的服务器名称。
`auth.params.port`	AWS Redshift服务器用于侦听客户端连接的TCP端口。
`auth.params.username`	与您的AWS Redshift帐户关联的用户名。
`auth.params.password`	与用户帐户对应的密码。
`auth.params.database`	从中获取数据的AWS Redshift数据库。
`auth.params.schema`	与您的AWS Redshift数据库关联的架构的名称。您必须确保要为其授予数据库访问权限的用户也具有此架构的访问权限。
`connectionSpec.id`	AWS Redshift连接规范ID： `3416976c-a9ca-4bba-901a-1f08f66978ff`

响应

成功的响应返回新创建的连接的详细信息，包括其唯一标识符(id)。在下一个教程中，需要此ID来浏览您的存储。

选择以查看示例

code language-json
`{ "id": "4cb0c374-d3bb-4557-b139-5712880adc55", "etag": "\"1700d77b-0000-0200-0000-5e3b41a10000\"" }`

后续步骤

通过完成本教程，您已使用Flow Service API创建了AWS Redshift基本连接。您可以在下列教程中使用此基本连接ID：

recommendation-more-help

experience-platform-help-sources