[Ultimate]{class="badge positive"}

Conectar o AWS Redshift ao Experience Platform usando a API Flow Service

Leia este guia para saber como você pode conectar sua conta de origem do AWS Redshift à Adobe Experience Platform usando a Flow Service API.

Introdução

Este manual necessita de uma compreensão funcional dos seguintes componentes da Adobe Experience Platform:

Uso de APIs do Experience Platform

Para obter informações sobre como fazer chamadas para APIs do Experience Platform com êxito, consulte o manual sobre introdução às APIs do Experience Platform.

Conectar o AWS Redshift ao Experience Platform no Azure azure

Leia as etapas abaixo para obter informações sobre como conectar sua origem do AWS Redshift ao Experience Platform no Azure.

Coletar credenciais necessárias

Forneça as propriedades de conexão necessárias para conectar Flow Service a AWS Redshift. Você também pode fornecer a propriedade table opcional para determinar o escopo da sua conexão com uma única tabela.

Para obter mais informações sobre a introdução, consulte este AWS Redshift documento.

Criar uma conexão base para AWS Redshift no Experience Platform no Azure [#azure-base]

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 AWS Redshift como parte dos parâmetros de solicitação.

Para determinar o escopo da conexão com uma única tabela, inclua auth.params.table em sua solicitação. Quando fornecido, a exploração de raiz (GET /connections/{BASE_CONNECTION_ID}/explore?objectType=root) retorna somente a tabela especificada. Omitir auth.params.table para retornar a lista completa de tabelas no banco de dados durante a exploração da raiz.

Formato da API

POST /connections

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": "AWS-redshift base connection",
      "description": "base connection for AWS-redshift",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "server": "{SERVER}",
              "port": "{PORT}",
              "username": "{USERNAME}",
              "password": "{PASSWORD}",
              "database": "{DATABASE}",
              "table": "{SCHEMA}.{TABLE}"
          }
      },
      "connectionSpec": {
          "id": "3416976c-a9ca-4bba-901a-1f08f66978ff",
          "version": "1.0"
      }
  }'

Resposta

{
    "id": "373e88fc-43da-4e3c-be88-fc43da3e3c0f",
    "etag": "\"1700ce7b-0000-0200-0000-5e3b405e0000\""
}

Conectar o AWS Redshift ao Experience Platform nos Serviços Web da AWS (AWS) aws

Leia as etapas abaixo para obter informações sobre como conectar sua origem do AWS Redshift ao Experience Platform no AWS.

Criar uma conexão base para AWS Redshift no Experience Platform no AWS aws-base

Formato da API

POST /connections

Solicitação

A solicitação a seguir cria uma conexão base para AWS Redshift:

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": "AWS Redshift base connection for Experience Platform on AWS",
      "description": "AWS Redshift base connection for Experience Platform on AWS",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "server": "{SERVER}",
              "port": "5439",
              "username": "{USERNAME}",
              "password": "{PASSWORD}",
              "database": "{DATABASE}",
              "schema": "{SCHEMA}"
          }
      },
      "connectionSpec": {
          "id": "3416976c-a9ca-4bba-901a-1f08f66978ff",
          "version": "1.0"
      }
  }'

Resposta

Uma resposta bem-sucedida retorna detalhes da conexão recém-criada, incluindo seu identificador exclusivo (id). Essa ID é necessária para explorar seu armazenamento no próximo tutorial.

{
    "id": "4cb0c374-d3bb-4557-b139-5712880adc55",
    "etag": "\"1700d77b-0000-0200-0000-5e3b41a10000\""
}

Próximas etapas

Seguindo este tutorial, você criou uma conexão de base AWS Redshift usando a API Flow Service. Você pode usar essa ID de conexão básica nos seguintes tutoriais: