[Ultimate]{class="badge positive"}

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

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:

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 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]

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

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

Risposta

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

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

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 aws-base

Formato API

POST /connections

Richiesta

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

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.

{
    "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: