[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的連線規格識別碼為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`。只提供一個結構描述和一個以單一句點分隔的表格。提供根探索時，只會傳回指定的資料表。省略後，根探索會傳回資料庫中的所有表格。
`connectionSpec.id`	AWS Redshift連線規格識別碼： `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多雲端總覽。

請閱讀下列步驟，以瞭解如何將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連線規格識別碼： `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