Connexion de PostgreSQL à Experience Platform à l’aide de l’API Flow Service

Lisez ce guide pour savoir comment connecter votre base de données PostgreSQL à Adobe Experience Platform à l’aide de l’Flow Service API.

Prise en main

Ce guide nécessite une compréhension professionnelle des composants suivants d’Experience Platform :

Les sections suivantes contiennent des informations supplémentaires que vous devez connaître pour réussir à vous connecter à PostgreSQL à l’aide de l’API Flow Service.

Utilisation des API Experience Platform

Lisez le guide sur Prise en main des API Experience Platform pour plus d’informations sur la manière d’effectuer avec succès des appels vers les API Experience Platform.

Collecter les informations d’identification requises

Lisez la PostgreSQL présentation pour plus d’informations sur l’authentification.

Activer le chiffrement SSL pour votre chaîne de connexion

Vous pouvez activer le chiffrement SSL pour votre chaîne de connexion PostgreSQL en ajoutant votre chaîne de connexion avec les propriétés suivantes :

Voici un exemple de chaîne de connexion PostgreSQL ajoutée avec le chiffrement SSL : Server={SERVER};Database={DATABASE};Port={PORT};UID={USERNAME};Password={PASSWORD};EncryptionMethod=1;ValidateServerCertificate=1.

Connecter PostgreSQL à Experience Platform sur Azure azure

Lisez les étapes ci-dessous pour savoir comment connecter votre compte PostgreSQL à Experience Platform sur Azure.

Créer une connexion de base azure-base

Une connexion de base conserve les informations échangées entre votre source et Experience Platform, y compris les informations d’authentification de votre source, l’état actuel de la connexion et votre identifiant de connexion de base unique. L’identifiant de connexion de base vous permet d’explorer et de parcourir des fichiers à partir de votre source et d’identifier les éléments spécifiques que vous souhaitez ingérer, y compris des informations concernant leurs types et formats de données.

Pour créer un identifiant de connexion de base, envoyez une requête POST au point d’entrée /connections et indiquez vos informations d’authentification PostgreSQL dans les paramètres de la requête.

Format d’API

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

Connexion de PostgreSQL à Experience Platform sur Amazon Web Services aws

Pour plus d’informations sur la connexion de votre base de données PostgreSQL à Experience Platform sur AWS, lisez les étapes ci-dessous.

Créer une connexion de base aws-base

Pour créer un identifiant de connexion de base, envoyez une requête POST au point d’entrée /connections lors de la fourniture des informations d’identification d’authentification PostgreSQL dans le cadre des paramètres de requête.

Format d’API

POST /connections

Requête

La requête suivante crée une connexion de base pour PostgreSQL connecter à Experience Platform sur 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"
      }
  }'

Réponse

Une réponse réussie renvoie l’identifiant unique (id) de la nouvelle connexion de base.

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

Étapes suivantes

Maintenant que vous avez créé une connexion entre votre base de données PostgreSQL et Experience Platform, vous pouvez passer aux étapes suivantes et importer vos données PostgreSQL dans Experience Platform. Pour plus d’informations, consultez la documentation suivante :