Documentazione Experience Platform Guida ai connettori di origini

Connetti PostgreSQL ad Experience Platform utilizzando l'API Flow Service

Ultimo aggiornamento: 21 maggio 2025

Argomenti:

Creato per:

Sviluppatore

Leggere questa guida per scoprire come collegare il database PostgreSQL a Adobe Experience Platform utilizzando Flow Service API.

Introduzione

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

Origini: Experience Platform consente di acquisire dati da varie origini e allo stesso tempo 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 Experience Platform in ambienti virtuali separati, utili per le attività di sviluppo e aggiornamento delle applicazioni di esperienza digitale.

Le sezioni seguenti forniscono informazioni aggiuntive che è necessario conoscere per connettersi correttamente a PostgreSQL utilizzando l'API Flow Service.

Utilizzo delle API di Experience Platform

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

Raccogli le credenziali richieste

Per ulteriori informazioni sull'autenticazione, leggere la PostgreSQL panoramica.

Abilita crittografia SSL per la stringa di connessione

È possibile abilitare la crittografia SSL per la stringa di connessione PostgreSQL aggiungendo la stringa di connessione con le proprietà seguenti:

Proprietà	Descrizione	Esempio
`EncryptionMethod`	Consente di abilitare la crittografia SSL nei dati PostgreSQL.	`EncryptionMethod=0`(Disabilitato) `EncryptionMethod=1`(abilitato) `EncryptionMethod=6`(RequestSSL)
`ValidateServerCertificate`	Convalida il certificato inviato dal database PostgreSQL quando viene applicato `EncryptionMethod`.	`ValidationServerCertificate=0`(Disabilitato) `ValidationServerCertificate=1`(abilitato)

Di seguito è riportato un esempio di stringa di connessione PostgreSQL a cui è stata aggiunta la crittografia SSL: Server={SERVER};Database={DATABASE};Port={PORT};UID={USERNAME};Password={PASSWORD};EncryptionMethod=1;ValidateServerCertificate=1.

Connetti PostgreSQL ad Experience Platform su Azure

Per informazioni su come collegare l'account PostgreSQL ad Experience Platform su Azure, leggere la procedura riportata di seguito.

Creare una connessione di 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 PostgreSQL come parte dei parametri della richiesta.

Formato API

POST /connections

Autenticazione basata su chiave account

Richiesta

La richiesta seguente crea una connessione di base per PostgreSQL utilizzando l'autenticazione basata su chiave account:

Esempio di richiesta View

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": "PostgreSQL base connection",
      "description": "PostgreSQL base connection via connection string",
      "auth": {
          "specName": "Connection String Based Authentication",
          "params": {
              "connectionString": "Server={SERVER};Database={DATABASE};Port={PORT};UID={USERNAME};Password={PASSWORD}"
          }
      },
      "connectionSpec": {
          "id": "74a1c565-4e59-48d7-9d67-7c03b8a13137",
          "version": "1.0"
      }
  }'

Proprietà	Descrizione
`auth.params.connectionString`	Stringa di connessione associata all'account PostgreSQL. Schema della stringa di connessione PostgreSQL: `Server={SERVER};Database={DATABASE};Port={PORT};UID={USERNAME};Password={PASSWORD}`.
`connectionSpec.id`	ID della specifica di connessione PostgreSQL: `74a1c565-4e59-48d7-9d67-7c03b8a13137`.

Risposta

In caso di esito positivo, la risposta restituisce l'identificatore univoco (id) della connessione di base appena creata.

Visualizza esempio di risposta

{
    "id": "056dd1b4-da33-42f9-add1-b4da3392f94e",
    "etag": "\"1700e582-0000-0200-0000-5e3c85180000\""
}

Autenticazione di base

Richiesta

La richiesta seguente crea una connessione di base per PostgreSQL utilizzando l'autenticazione di base:

Esempio di richiesta View

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": "PostgreSQL base connection",
      "description": "PostgreSQL base connection via basic authentication",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "server": "localhost",
              "port": "3306",
              "database": "postgresql-acme",
              "username": "acme",
              "password": "xxxx",
              "sslMode": "Allow"
          }
      },
      "connectionSpec": {
          "id": "74a1c565-4e59-48d7-9d67-7c03b8a13137",
          "version": "1.0"
      }
  }'

Proprietà

Descrizione

auth.params.server

Il nome o l'indirizzo IP del database PostgreSQL.

auth.params.port

Numero di porta del server di database.

auth.params.database

Nome del database PostgreSQL.

auth.params.username

Il nome utente associato all'autenticazione del database PostgreSQL.

auth.params.password

La password associata all'autenticazione del database PostgreSQL.

auth.params.sslMode

Il metodo con cui i dati vengono crittografati durante il trasferimento. I valori disponibili includono: Disable, Allow, Prefer, Verify Ca e Verify Full.

connectionSpec.id

ID della specifica di connessione PostgreSQL: 74a1c565-4e59-48d7-9d67-7c03b8a13137.

Risposta

In caso di esito positivo, la risposta restituisce l'identificatore univoco (id) della connessione di base appena creata.

Visualizza esempio di risposta

{
    "id": "2c15b1c5-73bf-47ab-9098-0467fcd854d9",
    "etag": "\"2600fc39-0000-0200-0000-67dd48f80000\""
}

Connetti PostgreSQL ad Experience Platform su Amazon Web Services

AVAILABILITY

Questa sezione si applica alle implementazioni di Experience Platform in esecuzione su Amazon 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 il database PostgreSQL ad Experience Platform su AWS, leggere la procedura seguente.

Creare una connessione di base

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

Formato API

POST /connections

Richiesta

La richiesta seguente crea una connessione di base per PostgreSQL per connettersi ad Experience Platform su AWS.

Esempio di richiesta View

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": "PostgreSQL base connection",
      "description": "PostgreSQL base connection via basic authentication",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "server": "localhost",
              "port": "3306",
              "database": "postgresql-acme",
              "username": "acme",
              "password": "xxxx",
              "sslMode": "false"
          }
      },
      "connectionSpec": {
          "id": "74a1c565-4e59-48d7-9d67-7c03b8a13137",
          "version": "1.0"
      }
  }'

Proprietà

Descrizione

auth.params.server

Il nome o l'indirizzo IP del database PostgreSQL.

auth.params.port

Numero di porta del server di database.

auth.params.database

Nome del database PostgreSQL.

auth.params.username

Il nome utente associato all'autenticazione del database PostgreSQL.

auth.params.password

La password associata all'autenticazione del database PostgreSQL.

sslMode

Valore booleano che controlla se SSL è applicato o meno, a seconda del supporto del server. Il valore predefinito di questa configurazione è false.

connectionSpec.id

ID della specifica di connessione PostgreSQL: 74a1c565-4e59-48d7-9d67-7c03b8a13137.

Risposta

In caso di esito positivo, la risposta restituisce l'identificatore univoco (id) della connessione di base appena creata.

Visualizza esempio di risposta

{
    "id": "2c15b1c5-73bf-47ab-9098-0467fcd854d9",
    "etag": "\"2600fc39-0000-0200-0000-67dd48f80000\""
}

Passaggi successivi

Dopo aver creato una connessione tra il database PostgreSQL e Experience Platform, è ora possibile procedere con i passaggi successivi e portare i dati di PostgreSQL in Experience Platform. Per ulteriori informazioni, consulta la seguente documentazione:

recommendation-more-help