[Ultimate]{class="badge positive"}

Anslut AWS Redshift till Experience Platform med API:t Flow Service

IMPORTANT
Källan AWS Redshift är tillgänglig i källkatalogen för användare som har köpt Real-Time Customer Data Platform Ultimate.

Läs den här vägledningen när du vill veta hur du kan ansluta ditt AWS Redshift-källkonto till Adobe Experience Platform med Flow Service API.

Komma igång

Handboken kräver en fungerande förståelse av följande komponenter i Adobe Experience Platform:

  • Källor: Experience Platform tillåter att data kan hämtas från olika källor samtidigt som du kan strukturera, etikettera och förbättra inkommande data med Experience Platform-tjänster.
  • Sandlådor: Experience Platform innehåller virtuella sandlådor som partitionerar en enskild Experience Platform-instans till separata virtuella miljöer för att hjälpa till att utveckla och utveckla program för digitala upplevelser.

Använda Experience Platform API:er

Information om hur du kan anropa Experience Platform API:er finns i guiden Komma igång med Experience Platform API:er.

Anslut AWS Redshift till Experience Platform på Azure azure

Läs stegen nedan om du vill ha information om hur du ansluter din AWS Redshift-källa till Experience Platform på Azure.

Samla in nödvändiga inloggningsuppgifter

För att Flow Service ska kunna ansluta till AWS Redshift måste du ange följande anslutningsegenskaper:

| Autentiseringsuppgifter | Beskrivning |
| server | Servernamnet för AWS Redshift -instansen. |
| port | Den TCP-port som en AWS Redshift -server använder för att avlyssna klientanslutningar. |
| username | Användarnamnet som är associerat med ditt AWS Redshift -konto. |
| password | Lösenordet som motsvarar användarkontot. |
| database | Den AWS Redshift -databas från vilken data ska hämtas. |
| connectionSpec.id | Anslutningsspecifikationen returnerar en källas kopplingsegenskaper, inklusive autentiseringsspecifikationer för att skapa bas- och källanslutningarna. Anslutningsspecifikations-ID för AWS Redshift är 3416976c-a9ca-4bba-901a-1f08f66978ff. |

Mer information om hur du kommer igång finns i det här AWS Redshift dokumentet.

Skapa en basanslutning för AWS Redshift på Experience Platform på Azure [#azure-base ]

NOTE
Standardkodningsstandarden för Redshift är Unicode. Detta kan inte ändras.

En basanslutning bevarar information mellan källan och Experience Platform, inklusive autentiseringsuppgifter för källan, anslutningens aktuella tillstånd och ditt unika basanslutnings-ID. Med det grundläggande anslutnings-ID:t kan du utforska och navigera bland filer inifrån källan och identifiera de specifika objekt som du vill importera, inklusive information om deras datatyper och format.

Om du vill skapa ett basanslutnings-ID skickar du en POST-begäran till /connections-slutpunkten och anger dina AWS Redshift-autentiseringsuppgifter som en del av parametrarna för begäran.

API-format

POST /connections

Begäran

Markera för att visa exempel

Följande begäran skapar en basanslutning för 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
Egenskap Beskrivning
auth.params.server Servernamnet för din AWS Redshift-instans.
auth.params.port TCP-porten som en AWS Redshift-server använder för att avlyssna klientanslutningar.
auth.params.username Användarnamnet som är associerat med ditt AWS Redshift-konto.
auth.params.password Lösenordet som motsvarar användarkontot.
auth.params.database Databasen AWS Redshift från vilken data ska hämtas.
connectionSpec.id Anslutningsspecifikations-ID AWS Redshift: 3416976c-a9ca-4bba-901a-1f08f66978ff

Svar

Markera för att visa exempel

Ett svar returnerar den nyligen skapade anslutningen, inklusive dess unika identifierare (id). Detta ID krävs för att utforska dina data i nästa självstudiekurs.

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

Anslut AWS Redshift till Experience Platform på AWS webbtjänster (AWS) aws

AVAILABILITY
Detta avsnitt gäller implementeringar av Experience Platform som körs på AWS Web Services (AWS). Experience Platform som körs på AWS är för närvarande tillgängligt för ett begränsat antal kunder. Mer information om den Experience Platform-infrastruktur som stöds finns i Experience Platform översikt över flera moln.

Läs stegen nedan om du vill ha information om hur du ansluter din AWS Redshift-källa till Experience Platform på AWS.

Skapa en basanslutning för AWS Redshift på Experience Platform på AWS aws-base

API-format

POST /connections

Begäran

Följande begäran skapar en basanslutning för AWS Redshift:

Markera för att visa exempel
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
Egenskap Beskrivning
auth.params.server Servernamnet för din AWS Redshift-instans.
auth.params.port TCP-porten som en AWS Redshift-server använder för att avlyssna klientanslutningar.
auth.params.username Användarnamnet som är associerat med ditt AWS Redshift-konto.
auth.params.password Lösenordet som motsvarar användarkontot.
auth.params.database Databasen AWS Redshift från vilken data ska hämtas.
auth.params.schema Namnet på schemat som är associerat med din AWS Redshift-databas. Du måste se till att användaren som du vill ge databasåtkomst till också har åtkomst till det här schemat.
connectionSpec.id Anslutningsspecifikations-ID AWS Redshift: 3416976c-a9ca-4bba-901a-1f08f66978ff

Svar

Ett lyckat svar returnerar information om den nyligen skapade anslutningen, inklusive dess unika identifierare (id). Detta ID krävs för att du ska kunna utforska ditt lagringsutrymme i nästa självstudiekurs.

Markera för att visa exempel
code language-json
{
    "id": "4cb0c374-d3bb-4557-b139-5712880adc55",
    "etag": "\"1700d77b-0000-0200-0000-5e3b41a10000\""
}

Nästa steg

Genom att följa den här självstudiekursen har du skapat en AWS Redshift-basanslutning med API:t Flow Service. Du kan använda detta grundläggande anslutnings-ID i följande självstudier:

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