Conectar PostgreSQL ao Experience Platform no Azure

Leia as etapas abaixo para saber como conectar sua conta do PostgreSQL à Experience Platform no Azure.

Criar uma conexão básica

Uma conexão base retém informações entre sua origem e a Experience Platform, incluindo as credenciais de autenticação da origem, o estado atual da conexão e a ID de conexão base exclusiva. A ID de conexão básica permite explorar e navegar pelos arquivos de dentro da origem e identificar os itens específicos que deseja assimilar, incluindo informações sobre os tipos de dados e formatos.

Para criar uma ID de conexão base, faça uma solicitação POST para o ponto de extremidade /connections ao fornecer suas credenciais de autenticação PostgreSQL como parte dos parâmetros de solicitação.

Formato da API

POST /connections

Solicitação

A solicitação a seguir cria uma conexão base para PostgreSQL usando a autenticação baseada em chave de conta:

Exibir exemplo de solicitação
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"
      }
  }'
PropriedadeDescrição
auth.params.connectionStringA cadeia de conexão associada à sua conta PostgreSQL. O padrão da cadeia de conexão PostgreSQL é: Server={SERVER};Database={DATABASE};Port={PORT};UID={USERNAME};Password={PASSWORD}.
connectionSpec.idAs IDs de especificação de conexão PostgreSQL: 74a1c565-4e59-48d7-9d67-7c03b8a13137.

Resposta

Uma resposta bem-sucedida retorna o identificador exclusivo (id) da conexão base recém-criada.

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

Solicitação

A solicitação a seguir cria uma conexão base para PostgreSQL usando autenticação básica:

Exibir exemplo de solicitação
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"
      }
  }'
PropriedadeDescrição
auth.params.serverO nome ou endereço IP do banco de dados PostgreSQL.
auth.params.portO número da porta do servidor de banco de dados.
auth.params.databaseO nome do banco de dados PostgreSQL.
auth.params.usernameO nome de usuário associado à autenticação do banco de dados do PostgreSQL.
auth.params.passwordA senha associada à autenticação do banco de dados do PostgreSQL.
auth.params.sslModeO método pelo qual os dados são criptografados durante a transferência. Os valores disponíveis incluem: Disable, Allow, Prefer, Verify Ca e Verify Full.
connectionSpec.idAs IDs de especificação de conexão PostgreSQL: 74a1c565-4e59-48d7-9d67-7c03b8a13137.

Resposta

Uma resposta bem-sucedida retorna o identificador exclusivo (id) da conexão base recém-criada.

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