Verbinding maken met Experience Platform via de Flow Service APIPostgreSQL

Lees deze gids om te leren hoe te om uw PostgreSQL gegevensbestand met Adobe Experience Platform te verbinden gebruikend Flow Service API ​.

Aan de slag

Deze handleiding vereist een goed begrip van de volgende onderdelen van Experience Platform:

In de volgende secties vindt u aanvullende informatie die u moet weten voordat u verbinding kunt maken met PostgreSQL via de Flow Service API.

Experience Platform API's gebruiken

Lees de gids op ​ begonnen wordt met Experience Platform APIs ​ voor informatie over hoe te met succes vraag aan Experience Platform APIs maken.

Vereiste referenties verzamelen

Lees het PostgreSQL overzicht ​ voor meer informatie over authentificatie.

SSL-versleuteling inschakelen voor uw verbindingstekenreeks

U kunt SSL-codering inschakelen voor de PostgreSQL -verbindingstekenreeks door uw verbindingstekenreeks toe te voegen met de volgende eigenschappen:

Hier volgt een voorbeeld van een PostgreSQL verbindingstekenreeks die is toegevoegd met SSL-codering: Server={SERVER};Database={DATABASE};Port={PORT};UID={USERNAME};Password={PASSWORD};EncryptionMethod=1;ValidateServerCertificate=1 .

Verbind PostgreSQL met Experience Platform op Azure azure

Lees de onderstaande stappen om te leren hoe u uw PostgreSQL -account kunt verbinden met Experience Platform on Azure.

Een basisverbinding maken azure-base

Een basisverbinding behoudt informatie tussen uw bron en Experience Platform, met inbegrip van de verificatiereferenties van uw bron, de huidige status van de verbinding, en uw unieke identiteitskaart van de basisverbinding. Met de ID van de basisverbinding kunt u bestanden verkennen en door bestanden navigeren vanuit uw bron en kunt u de specifieke items identificeren die u wilt opnemen, inclusief informatie over hun gegevenstypen en indelingen.

Als u een basis-verbindings-id wilt maken, vraagt u een POST-aanvraag naar het /connections -eindpunt en geeft u de PostgreSQL -verificatiegegevens op als onderdeel van de aanvraagparameters.

API formaat

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

Verbinden PostgreSQL met Experience Platform op Amazon Web Services aws

Lees de onderstaande stappen voor informatie over hoe u uw PostgreSQL -database kunt verbinden met Experience Platform op AWS.

Een basisverbinding maken aws-base

Als u een basis-verbindings-id wilt maken, vraagt u een POST-aanvraag naar het /connections -eindpunt en geeft u de PostgreSQL -verificatiegegevens op als onderdeel van de aanvraagparameters.

API formaat

POST /connections

Verzoek

Met de volgende aanvraag wordt een basisverbinding voor PostgreSQL gemaakt om verbinding te maken met Experience Platform op 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"
      }
  }'

Reactie

Een succesvolle reactie keert het unieke herkenningsteken (id) van de pas gecreëerde basisverbinding terug.

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

Volgende stappen

Nu u een verbinding hebt gemaakt tussen uw PostgreSQL -database en Experience Platform, kunt u nu verdergaan en de PostgreSQL -gegevens naar Experience Platform overbrengen. Raadpleeg de volgende documentatie voor meer informatie: