使用Flow Service API建立HP Vertica源連接

注意

HP Vertica介面處於測試階段。 有關使用beta標籤連接器的詳細資訊,請參閱來源概觀

Flow Service 用於收集和集中Adobe Experience Platform內不同來源的客戶資料。該服務提供用戶介面和REST風格的API,所有支援的源都可從中連接。

本教程使用Flow Service API來引導您完成將HP Vertica連接到Experience Platform的步驟。

快速入門

本指南需要有效瞭解Adobe Experience Platform的下列元件:

  • 來源: Experience Platform 可讓您從各種來源擷取資料,同時提供使用服務來建構、對應及增強傳入資料的 Platform 能力。
  • 沙盒: Experience Platform 提供虛擬沙盒,可將單一執行個體分 Platform 割為不同的虛擬環境,以協助開發和發展數位體驗應用程式。

以下各節提供您需要瞭解的其他資訊,以便使用Flow Service API成功連接到HP Vertica。

收集必要的認證

要使Flow Service與HP Vertica連接,必須為以下連接屬性提供值:

憑證 說明
connectionString 用於連接到HP Vertica實例的連接字串。 HP Vertica的連接字串模式是Server={SERVER};Port={PORT};Database={DATABASE};UID={USERNAME};PWD={PASSWORD}
connectionSpec.id 建立連線所需的識別碼。 HP Vertica的固定連接規範ID為:a8b6a1a4-5735-42b4-952c-85dce0ac38b5

有關獲取連接字串的詳細資訊,請參閱此HP Vertica文檔

讀取範例API呼叫

本教學課程提供範例API呼叫,以示範如何設定請求的格式。 這些包括路徑、必要標題和正確格式化的請求負載。 也提供API回應中傳回的範例JSON。 如需範例API呼叫檔案中所用慣例的詳細資訊,請參閱Experience Platform疑難排解指南中如何讀取範例API呼叫一節。

收集必要標題的值

若要呼叫Platform API,您必須先完成驗證教學課程。 完成驗證教學課程後,所有Experience Platform API呼叫中每個所需標題的值都會顯示在下面:

  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {IMS_ORG}

Experience Platform中的所有資源(包括屬於Flow Service的資源)都與特定虛擬沙盒隔離。 對Platform API的所有請求都需要一個標題,該標題指定要在中執行操作的沙盒的名稱:

  • x-sandbox-name: {SANDBOX_NAME}

所有包含裝載(POST、PUT、PATCH)的請求都需要額外的媒體類型標題:

  • Content-Type: application/json

建立連線

連接指定源,並包含該源的憑據。 每個HP Vertica帳戶只需要一個連接,因為它可用於建立多個源連接器以導入不同的資料。

API格式

POST /connections

請求

要建立HP Vertica連接,必須在POST請求中提供其唯一連接規範ID。 HP Vertica的連接規範ID為a8b6a1a4-5735-42b4-952c-85dce0ac38b5

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: {IMS_ORG}' \
    -H 'x-sandbox-name: {SANDBOX_NAME}' \
    -H 'Content-Type: application/json' \
    -d '{
        "name": "Connection for HP Vertica",
        "description": "Connection for HP Vertica",
        "auth": {
            "specName": "Connection String Based Authentication",
            "params": {
                "connectionString": "Server={SERVER};Port={PORT};Database={DATABASE};UID={USERNAME};PWD={PASSWORD}"
            }
        },
        "connectionSpec": {
            "id": "a8b6a1a4-5735-42b4-952c-85dce0ac38b5",
            "version": "1.0"
        }
    }'
參數 說明
auth.params.connectionString 與HP Vertica帳戶關聯的連接字串。 HP Vertica的連接字串模式是:Server={SERVER};Port={PORT};Database={DATABASE};UID={USERNAME};PWD={PASSWORD}
connectionSpec.id HP Vertica連接規範ID:a8b6a1a4-5735-42b4-952c-85dce0ac38b5

回應

成功的響應返回新建立的連接的詳細資訊,包括其唯一標識符(id)。 在下一個教學課程中探索資料時,需要此ID。

{
    "id": "6bc13a3b-3546-455f-813a-3b3546a55fb1",
    "etag": "\"3500866c-0000-0200-0000-5e83afa30000\""
}

後續步驟

在本教程中,您使用Flow Service API建立了HP Vertica連接,並獲取了該連接的唯一ID值。 在下一個教學課程中,您可以使用此ID來學習如何使用流服務API](…/…/explore/database-nosql.md)來探索資料庫。[

本頁內容

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now