Dokumentation Experience Platform Användarhandbok om Source Connectors

Anslut MariaDB till Experience Platform med API:t Flow Service

Last update: Wed May 21 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Ämnen:

Skapat för:

Utvecklare

Läs den här vägledningen när du vill lära dig hur du ansluter ditt MariaDB-konto till Adobe Experience Platform med Flow Service API.

Kom igång

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

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

I följande avsnitt finns ytterligare information som du behöver känna till för att kunna ansluta till MariaDB med API:t Flow Service.

Samla in nödvändiga inloggningsuppgifter

Läs MariaDB översikten om du vill ha information om autentisering.

Använda Experience Platform API:er

Läs guiden Komma igång med Experience Platform API:er om du vill ha information om hur du kan anropa Experience Platform API:er.

Anslut MariaDB till Experience Platform

Läs stegen nedan om du vill ha information om hur du ansluter ditt MariaDB-konto till Experience Platform.

Skapa en basanslutning för MariaDB

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.

API-format

POST /connections

Om du vill skapa ett basanslutnings-ID skickar du en POST-begäran till /connections-slutpunkten och anger autentiseringsuppgifterna för ditt MariaDB-konto.

Anslutningssträngsbaserad autentisering

Begäran

Följande begäran skapar en basanslutning för en MariaDB-källa med anslutningssträngsbaserad autentisering.

accordion

Exempel på visningsbegäran

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": "MariaDB connection",
    "description": "MariaDB connection",
    "auth": {
        "specName": "Connection String Based Authentication",
        "params": {
            "connectionString": "Server={HOST};Port={PORT};Database={DATABASE};UID={USERNAME};PWD={PASSWORD}"
        }
    },
    "connectionSpec": {
        "id": "3000eb99-cd47-43f3-827c-43caf170f015",
        "version": "1.0"
    }
}'

table 0-row-2 1-row-2 2-row-2
Egenskap	Beskrivning
`auth.params.connectionString`	Anslutningssträngen som är associerad med din MariaDB-autentisering. Anslutningssträngsmönstret MariaDB är: `Server={HOST};Port={PORT};Database={DATABASE};UID={USERNAME};PWD={PASSWORD}`.
`connectionSpec.id`	Anslutningsspecifikations-ID MariaDB är: `3000eb99-cd47-43f3-827c-43caf170f015`.

Svar

Ett godkänt svar returnerar information om den nya basanslutningen, inklusive dess unika identifierare (id).

accordion

Visa svarsexempel

code language-json
`{ "id": "be3a2d71-1fb6-4fea-ba2d-711fb61fea50", "etag": "\"02002624-0000-0200-0000-5e41f7040000\"" }`

Grundläggande autentisering

Begäran

Följande begäran skapar en basanslutning för en MariaDB-källa med grundläggande autentisering.

accordion

Exempel på visningsbegäran

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": "MariaDB on Experience Platform using basic auth",
      "description": "MariaDB on Experience Platform using basic auth",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "server": "{SERVER}",
              "database": "{DATABASE}",
              "username": "{USERNAME}",
              "password": "{PASSWORD}",
              "sslMode": "{SSLMODE}"
          }
      },
      "connectionSpec": {
          "id": "3000eb99-cd47-43f3-827c-43caf170f015",
          "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`	Namnet eller IP-adressen för din MariaDB-databas.
`auth.params.database`	Namnet på databasen.
`auth.params.username`	Användarnamnet som motsvarar databasen.
`auth.params.password`	Lösenordet som motsvarar databasen.
`auth.params.sslMode`	Den metod som används för att kryptera data under dataöverföring.
`connectionSpec.id`	Anslutningsspecifikations-ID MariaDB är: `3000eb99-cd47-43f3-827c-43caf170f015`.

Svar

Ett godkänt svar returnerar information om den nya basanslutningen, inklusive dess unika identifierare (id).

accordion

Visa svarsexempel

code language-json
`{ "id": "f847950c-1c12-4568-a550-d5312b16fdb8", "etag": "\"0c0099f4-0000-0200-0000-67da91710000\"" }`

Nästa steg

Genom att följa den här självstudiekursen har du skapat en MariaDB-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