ドキュメントExperience Platformソースコネクタガイド

を使用してクラウドストレージフォルダーを調べる Flow Service API

Last update: Tue Sep 12 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • Developer

このチュートリアルでは、 Flow Service API.

NOTE
クラウドストレージを参照するには、クラウドストレージソースの有効なベース接続 ID が既に存在している必要があります。 この ID がない場合、 ソースの概要 を参照してください。

はじめに

このガイドでは、Adobe Experience Platform の次のコンポーネントに関する十分な知識が必要です。

  • ソース：Experience Platform を使用すると、データを様々なソースから取得しながら、Platform サービスを使用して受信データの構造化、ラベル付け、拡張を行うことができます。
  • サンドボックス：Experience Platform には、単一の Platform インスタンスを別々の仮想環境に分割し、デジタルエクスペリエンスアプリケーションの開発と発展に役立つ仮想サンドボックスが用意されています。

Platform API の使用

Platform API を正常に呼び出す方法について詳しくは、Platform API の概要のガイドを参照してください。

クラウドストレージフォルダーを参照する

クラウドストレージフォルダーの構造に関する情報を取得するには、 Flow Service ソースのベース接続 ID を提供する際の API。

クラウドストレージを調査するためのGETリクエストを実行する場合、次の表に示すクエリパラメーターを含める必要があります。

パラメーター
説明
objectType

参照するオブジェクトのタイプ。 この値は次のいずれかに設定します。

  • folder：特定のディレクトリを参照します。
  • root：ルートディレクトリを参照します。
object
このパラメーターは、特定のディレクトリを表示する場合にのみ必要です。 値は、参照するディレクトリのパスを表します。

API 形式

GET /connections/{BASE_CONNECTION_ID}/explore?objectType=root
GET /connections/{BASE_CONNECTION_ID}/explore?objectType=folder&object={PATH}
パラメーター
説明
{BASE_CONNECTION_ID}
クラウドストレージソースのベース接続 ID。
{PATH}
ディレクトリのパス。

リクエスト

curl -X GET \
  'http://platform.adobe.io/data/foundation/flowservice/connections/dc3c0646-5e30-47be-a1ce-d162cb8f1f07/explore?objectType=folder&object=root' \
  -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}'

応答

正常な応答は、クエリされたディレクトリ内で見つかったファイルとフォルダーの配列を返します。 次の項目をメモします。 path プロパティを指定してファイルの構造を検査する必要があるので、アップロードするファイルのプロパティを設定します。

[
    {
        "type": "file",
        "name": "account.csv",
        "path": "/test-connectors/testFolder-fileIngestion/account.csv",
        "canPreview": true,
        "canFetchSchema": true
    },
    {
        "type": "file",
        "name": "profileData.json",
        "path": "/test-connectors/testFolder-fileIngestion/profileData.json",
        "canPreview": true,
        "canFetchSchema": true
    },
    {
        "type": "file",
        "name": "sampleprofile--3.parquet",
        "path": "/test-connectors/testFolder-fileIngestion/sampleprofile--3.parquet",
        "canPreview": true,
        "canFetchSchema": true
    }
]

Inspectファイルの構造

クラウドストレージからGETファイルの構造を調べるには、ファイルのパスと型をクエリパラメーターとして指定し、データリクエストを実行します。

ファイルのパスとタイプを指定してGETリクエストを実行することで、クラウドストレージソースからデータファイルの構造を調べることができます。 また、CSV、TSV、圧縮 JSON、区切り形式のファイルなど、様々なファイルタイプを検査する場合は、クエリパラメーターの一部としてファイルタイプを指定します。

API 形式

GET /connections/{BASE_CONNECTION_ID}/explore?objectType=file&object={FILE_PATH}&fileType={FILE_TYPE}&{QUERY_PARAMS}&preview=true
GET /connections/{BASE_CONNECTION_ID}/explore?objectType=file&object={FILE_PATH}&preview=true&fileType=delimited&columnDelimiter=\t
GET /connections/{BASE_CONNECTION_ID}/explore?objectType=file&object={FILE_PATH}&preview=true&fileType=delimited&compressionType=gzip;
GET /connections/{BASE_CONNECTION_ID}/explore?objectType=FILE&object={FILE_PATH}&preview=true&fileType=delimited&encoding=ISO-8859-1;
パラメーター
説明
{BASE_CONNECTION_ID}
クラウドストレージソースコネクタの接続 ID。
{FILE_PATH}
検査するファイルへのパス。
{FILE_TYPE}

ファイルのタイプ。 次のファイルタイプがサポートされています。

  • 区切り：区切り文字で区切られた値。 DSV ファイルはコンマで区切る必要があります。
  • JSON:JavaScript オブジェクト表記。 JSON ファイルは XDM に準拠している必要があります
  • PARQUET:Apache Parquet。 Parquet ファイルは XDM に準拠している必要があります。
{QUERY_PARAMS}
結果のフィルタリングに使用できるオプションのクエリパラメーター。 詳しくは、 クエリパラメーター を参照してください。

リクエスト

curl -X GET \
    'http://platform.adobe.io/data/foundation/flowservice/connections/{BASE_CONNECTION_ID}/explore?objectType=file&object=/aep-bootcamp/Adobe%20Pets%20Customer%2020190801%20EXP.json&fileType=json&preview=true' \
    -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}'

応答

正常な応答は、クエリされたファイルの構造（テーブル名とデータ型を含む）を返します。

[
    {
        "name": "Id",
        "type": "String"
    },
    {
        "name": "FirstName",
        "type": "String"
    },
    {
        "name": "LastName",
        "type": "String"
    },
    {
        "name": "Email",
        "type": "String"
    },
    {
        "name": "Phone",
        "type": "String"
    }
]

クエリパラメーターの使用 query

The Flow Service API では、様々なファイルタイプのプレビューと検査をおこなうためのクエリパラメーターの使用をサポートしています。

パラメーター
説明
columnDelimiter
CSV または TSV ファイルを検査する列区切り文字として指定した 1 文字の値。 パラメーターを指定しない場合、値はデフォルトでコンマになります (,).
compressionType

圧縮された区切りファイルまたは JSON ファイルをプレビューするための必須クエリパラメーター。 サポートされる圧縮ファイルは次のとおりです。

  • bzip2
  • gzip
  • deflate
  • zipDeflate
  • tarGzip
  • tar
encoding
プレビューのレンダリング時に使用するエンコーディングの種類を定義します。 サポートされるエンコーディングの種類は次のとおりです。 UTF-8 および ISO-8859-1. 注意: encoding パラメーターは、区切られた CSV ファイルを取り込む場合にのみ使用できます。 その他のファイルタイプは、デフォルトのエンコーディングで取り込まれ、 UTF-8.

次の手順

このチュートリアルに従って、クラウドストレージシステムを調べ、に取り込むファイルのパスを見つけました。 Platformをクリックし、その構造を確認しました。 次のチュートリアルでこの情報を使用して、 クラウドストレージからデータを収集し、Platform に取り込む.

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