Ultimate

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

最近更新： 2025年4月4日

主题：

创建对象：

开发人员

重要

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

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

收集所需的凭据

为了使Flow Service与AWS Redshift连接，您必须提供以下连接属性：

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

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

注意

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

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

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

API格式

POST /connections

请求

选择以查看示例

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

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}"
          }
      },
      "connectionSpec": {
          "id": "3416976c-a9ca-4bba-901a-1f08f66978ff",
          "version": "1.0"
      }
  }'

属性

描述

auth.params.server

AWS Redshift实例的服务器名称。

auth.params.port

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

auth.params.username

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

auth.params.password

与用户帐户对应的密码。

auth.params.database

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

connectionSpec.id

AWS Redshift连接规范ID： 3416976c-a9ca-4bba-901a-1f08f66978ff

响应

选择以查看示例

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

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

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

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创建基本连接

API格式

POST /connections

请求

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

选择以查看示例

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"
      }
  }'

属性

描述

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来浏览您的存储。

选择以查看示例

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

后续步骤

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

recommendation-more-help