Documentazione Experience Platform Guida ai connettori di origini

Ultimate

Connetti AWS Redshift ad Experience Platform utilizzando l'API Flow Service

Ultimo aggiornamento: 4 aprile 2025

Argomenti:

Creato per:

Sviluppatore

IMPORTANT

L'origine AWS Redshift è disponibile nel catalogo delle origini per gli utenti che hanno acquistato Real-Time Customer Data Platform Ultimate.

Leggi questa guida per scoprire come collegare l'account di origine AWS Redshift a Adobe Experience Platform utilizzando Flow Service API.

Introduzione

Questa guida richiede una buona conoscenza dei seguenti componenti di Adobe Experience Platform:

Origini: Experience Platform consente l'acquisizione di dati da varie origini e consente di strutturare, etichettare e migliorare i dati in arrivo tramite i servizi Experience Platform.
Sandbox: Experience Platform fornisce sandbox virtuali che suddividono una singola istanza di Experience Platform in ambienti virtuali separati, utili per le attività di sviluppo e aggiornamento delle applicazioni di esperienza digitale.

Utilizzo delle API di Experience Platform

Per informazioni su come effettuare correttamente chiamate alle API di Experience Platform, consulta la guida introduttiva alle API di Experience Platform.

Connetti AWS Redshift ad Experience Platform su Azure

Per informazioni su come collegare l'origine AWS Redshift ad Experience Platform su Azure, leggere la procedura seguente.

Raccogli le credenziali richieste

Affinché Flow Service possa connettersi a AWS Redshift, è necessario fornire le seguenti proprietà di connessione:

| Credenziali | Descrizione |
| server | Il nome del server dell'istanza AWS Redshift. |
| port | Porta TCP utilizzata da un server AWS Redshift per l'ascolto delle connessioni client. |
| username | Il nome utente associato al tuo account AWS Redshift. |
| password | Password corrispondente all'account utente. |
| database | Database AWS Redshift da cui recuperare i dati. |
| connectionSpec.id | La specifica di connessione restituisce le proprietà del connettore di un'origine, incluse le specifiche di autenticazione relative alla creazione delle connessioni di base e di origine. L'ID della specifica di connessione per AWS Redshift è 3416976c-a9ca-4bba-901a-1f08f66978ff. |

Per ulteriori informazioni su come iniziare, consulta questo AWS Redshift documento.

Crea una connessione di base per AWS Redshift in Experience Platform su Azure [#azure-base]

NOTE

Lo standard di codifica predefinito per Redshift è Unicode. Questo non può essere modificato.

Una connessione di base mantiene le informazioni tra l’origine e Experience Platform, incluse le credenziali di autenticazione dell’origine, lo stato corrente della connessione e l’ID univoco della connessione di base. L’ID della connessione di base consente di esplorare e navigare tra i file dall’interno dell’origine e identificare gli elementi specifici che desideri acquisire, comprese le informazioni relative ai tipi di dati e ai formati.

Per creare un ID connessione di base, eseguire una richiesta POST all'endpoint /connections fornendo le credenziali di autenticazione AWS Redshift come parte dei parametri della richiesta.

Formato API

POST /connections

Richiesta

Seleziona per visualizzare l’esempio

La richiesta seguente crea una connessione di base per 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"
      }
  }'

Proprietà

Descrizione

auth.params.server

Il nome del server dell'istanza AWS Redshift.

auth.params.port

Porta TCP utilizzata da un server AWS Redshift per l'ascolto delle connessioni client.

auth.params.username

Il nome utente associato al tuo account AWS Redshift.

auth.params.password

Password corrispondente all'account utente.

auth.params.database

Database AWS Redshift da cui recuperare i dati.

connectionSpec.id

ID della specifica di connessione AWS Redshift: 3416976c-a9ca-4bba-901a-1f08f66978ff

Risposta

Seleziona per visualizzare l’esempio

In caso di esito positivo, la risposta restituisce la connessione appena creata, incluso il relativo identificatore univoco (id). Questo ID è necessario per esplorare i dati nell’esercitazione successiva.

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

Connetti AWS Redshift ad Experience Platform su AWS Web Services (AWS)

AVAILABILITY

Questa sezione si applica alle implementazioni di Experience Platform in esecuzione su AWS Web Services (AWS). Experience Platform in esecuzione su AWS è attualmente disponibile per un numero limitato di clienti. Per ulteriori informazioni sull'infrastruttura Experience Platform supportata, consulta la Panoramica multi-cloud di Experience Platform.

Per informazioni su come collegare l'origine AWS Redshift ad Experience Platform su AWS, leggere i passaggi seguenti.

Crea una connessione di base per AWS Redshift su Experience Platform su AWS

Formato API

POST /connections

Richiesta

La richiesta seguente crea una connessione di base per AWS Redshift:

Seleziona per visualizzare l’esempio

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

Proprietà

Descrizione

auth.params.server

Il nome del server dell'istanza AWS Redshift.

auth.params.port

Porta TCP utilizzata da un server AWS Redshift per l'ascolto delle connessioni client.

auth.params.username

Il nome utente associato al tuo account AWS Redshift.

auth.params.password

Password corrispondente all'account utente.

auth.params.database

Database AWS Redshift da cui recuperare i dati.

auth.params.schema

Il nome dello schema associato al database AWS Redshift. È necessario assicurarsi che anche l'utente a cui si desidera concedere l'accesso al database abbia accesso a questo schema.

connectionSpec.id

ID della specifica di connessione AWS Redshift: 3416976c-a9ca-4bba-901a-1f08f66978ff

Risposta

In caso di esito positivo, la risposta restituisce i dettagli della connessione appena creata, incluso il relativo identificatore univoco (id). Questo ID è necessario per esplorare lo spazio di archiviazione nella prossima esercitazione.

Seleziona per visualizzare l’esempio

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

Passaggi successivi

Seguendo questa esercitazione, è stata creata una connessione di base AWS Redshift utilizzando l'API Flow Service. Puoi utilizzare questo ID connessione di base nelle seguenti esercitazioni:

recommendation-more-help