Anslut PostgreSQL till Experience Platform med API:t Flow Service

Läs den här vägledningen när du vill lära dig hur du ansluter din PostgreSQL-databas till Adobe Experience Platform med Flow Service API.

Komma igång

Handboken kräver en fungerande förståelse av följande komponenter i Experience Platform:

I följande avsnitt finns ytterligare information som du behöver känna till för att kunna ansluta till PostgreSQL med API:t Flow Service.

Använda Experience Platform API:er

Läs guiden Komma igång med Experience Platform API:er om du vill ha information om hur du kan anropa Experience Platform API:er.

Samla in nödvändiga inloggningsuppgifter

Läs PostgreSQL översikten om du vill ha mer information om autentisering.

Aktivera SSL-kryptering för anslutningssträngen

Du kan aktivera SSL-kryptering för anslutningssträngen PostgreSQL genom att lägga till anslutningssträngen med följande egenskaper:

Följande är ett exempel på en PostgreSQL-anslutningssträng med SSL-kryptering: Server={SERVER};Database={DATABASE};Port={PORT};UID={USERNAME};Password={PASSWORD};EncryptionMethod=1;ValidateServerCertificate=1.

Anslut PostgreSQL till Experience Platform på Azure azure

Läs stegen nedan för att lära dig hur du ansluter ditt PostgreSQL-konto till Experience Platform på Azure.

Skapa en basanslutning azure-base

En basanslutning bevarar information mellan källan och Experience Platform, inklusive autentiseringsuppgifter för källan, anslutningens aktuella tillstånd och ditt unika basanslutnings-ID. Med det grundläggande anslutnings-ID:t kan du utforska och navigera bland filer inifrån källan och identifiera de specifika objekt som du vill importera, inklusive information om deras datatyper och format.

Om du vill skapa ett basanslutnings-ID skickar du en POST-begäran till /connections-slutpunkten och anger dina PostgreSQL-autentiseringsuppgifter som en del av parametrarna för begäran.

API-format

POST /connections

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

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

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

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

Anslut PostgreSQL till Experience Platform på Amazon Web Services aws

Läs stegen nedan om du vill ha information om hur du ansluter din PostgreSQL-databas till Experience Platform på AWS.

Skapa en basanslutning aws-base

Om du vill skapa ett basanslutnings-ID skickar du en POST-begäran till /connections-slutpunkten och anger dina PostgreSQL-autentiseringsuppgifter som en del av parametrarna för begäran.

API-format

POST /connections

Begäran

Följande begäran skapar en basanslutning för PostgreSQL att ansluta till Experience Platform på AWS.

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

Svar

Ett lyckat svar returnerar den unika identifieraren (id) för den nyskapade basanslutningen.

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

Nästa steg

Nu när du har skapat en anslutning mellan din PostgreSQL-databas och Experience Platform kan du nu gå vidare till nästa steg och överföra dina PostgreSQL-data till Experience Platform. Mer information finns i följande dokumentation: