[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 AWS Redshift ao Experience Platform no Azure azure

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

Coletar credenciais necessárias

Para que Flow Service se conecte a AWS Redshift, você deve fornecer as seguintes propriedades de conexão:

| Credencial | Descrição |
| server | O nome do servidor da instância AWS Redshift. |
| port | A porta TCP que um servidor AWS Redshift usa para escutar conexões de clientes. |
| username | O nome de usuário associado à sua conta AWS Redshift. |
| password | A senha que corresponde à conta do usuário. |
| database | O banco de dados AWS Redshift do qual os dados devem ser obtidos. |
| connectionSpec.id | A especificação de conexão retorna as propriedades do conector de uma origem, incluindo especificações de autenticação relacionadas à criação das conexões de base e de origem. A ID da especificação de conexão para AWS Redshift é 3416976c-a9ca-4bba-901a-1f08f66978ff. |

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.

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}"
          }
      },
      "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: