[Ultimate]{class="badge positive"}

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

IMPORTANT
A origem AWS Redshift está disponível no catálogo de origens para usuários que compraram o Real-Time Customer Data Platform Ultimate.

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:

  • Fontes: Experience Platform permite que os dados sejam assimilados de várias fontes e fornece a capacidade de estruturar, rotular e aprimorar os dados recebidos usando os serviços do Experience Platform.
  • Sandboxes: Experience Platform fornece sandboxes virtuais que particionam uma única instância do Experience Platform em ambientes virtuais separados para ajudar a desenvolver aplicativos de experiência digital.

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]

NOTE
O padrão de codificação para Redshift é Unicode. Isso não pode ser alterado.

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

Selecione para exibir o exemplo

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

code language-shell
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"
      }
  }'
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
Propriedade Descrição
auth.params.server O nome do servidor da instância AWS Redshift.
auth.params.port A porta TCP que um servidor AWS Redshift usa para escutar conexões de clientes.
auth.params.username O nome de usuário associado à sua conta AWS Redshift.
auth.params.password A senha que corresponde à conta do usuário.
auth.params.database O banco de dados AWS Redshift do qual os dados devem ser obtidos.
connectionSpec.id A ID da especificação de conexão AWS Redshift: 3416976c-a9ca-4bba-901a-1f08f66978ff

Resposta

Selecione para exibir o exemplo

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

code language-json
{
    "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

AVAILABILITY
Esta seção se aplica às implementações do Experience Platform executadas no AWS Web Services (AWS). O Experience Platform em execução no AWS está disponível atualmente para um número limitado de clientes. Para saber mais sobre a infraestrutura do Experience Platform compatível, consulte a visão geral da nuvem múltipla do Experience Platform.

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:

Selecione para exibir o exemplo
code language-shell
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"
      }
  }'
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2
Propriedade Descrição
auth.params.server O nome do servidor da instância AWS Redshift.
auth.params.port A porta TCP que um servidor AWS Redshift usa para escutar conexões de clientes.
auth.params.username O nome de usuário associado à sua conta AWS Redshift.
auth.params.password A senha que corresponde à conta do usuário.
auth.params.database O banco de dados AWS Redshift do qual os dados devem ser obtidos.
auth.params.schema O nome do esquema associado ao banco de dados AWS Redshift. Você deve garantir que o usuário ao qual deseja conceder acesso ao banco de dados também tenha acesso a esse esquema.
connectionSpec.id A ID da especificação de conexão AWS Redshift: 3416976c-a9ca-4bba-901a-1f08f66978ff

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.

Selecione para exibir o exemplo
code language-json
{
    "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:

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089