를 사용하여 데이터 테이블 탐색 Flow Service API

이 자습서에서는 Flow Service API.

노트

데이터 테이블을 탐색하려면 테이블 형식 소스에 대해 유효한 기본 연결 ID가 있어야 합니다. 이 ID가 없는 경우, 표 형식의 소스에 대한 기본 연결 ID를 만드는 방법에 대한 단계를 보려면 다음 자습서를 참조하십시오.

시작하기

이 안내서에서는 Adobe Experience Platform의 다음 구성 요소를 이해하고 있어야 합니다.

  • 소스: Experience Platform 을(를) 사용하여 들어오는 데이터를 구조화, 레이블 지정 및 향상시키는 기능을 제공하면서 다양한 소스에서 데이터를 수집할 수 있습니다. Platform 서비스.
  • 샌드박스: Experience Platform 단일 파티션을 생성하는 가상 샌드박스 제공 Platform 디지털 경험 애플리케이션을 개발하고 발전시키는 데 도움이 되는 별도의 가상 환경으로 인스턴스를 구축할 수 있습니다.

플랫폼 API 사용

Platform API를 성공적으로 호출하는 방법에 대한 자세한 내용은 플랫폼 API 시작.

데이터 테이블 탐색

에 GET 요청을 수행하여 데이터 테이블의 구조에 대한 정보를 검색할 수 있습니다 Flow Service 소스의 기본 연결 ID를 제공하는 동안 API입니다.

API 형식

GET /connections/{BASE_CONNECTION_ID}/explore?objectType=root
매개 변수 설명
{BASE_CONNECTION_ID} 소스의 기본 연결 ID입니다.

요청

curl -X GET \
  'https://platform.adobe.io/data/foundation/flowservice/connections/5e73e5a2-dc36-45a8-9f16-93c7a43af318/explore?objectType=root' \
  -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}'

응답

성공적인 응답은 소스의 테이블 배열을 반환합니다. Platform으로 가져올 테이블을 찾아 그 내용을 주목하십시오 path 속성을 확인하기 위해 다음 단계에서 제공해야 하므로 속성을 검사합니다.

[
    {
        "type": "table",
        "name": "ACME Spring Campaign",
        "path": "acmeSpringCampaign",
        "canPreview": true,
        "canFetchSchema": true
    },
    {
        "type": "table",
        "name": "ACME Summer Campaign",
        "path": "acmeSummerCampaign",
        "canPreview": true,
        "canFetchSchema": true
    }
]

Inspect 테이블 구조

데이터 테이블의 내용을 검사하려면 Flow Service 테이블의 경로를 쿼리 매개 변수로 지정하는 동안 API입니다.

API 형식

GET /connections/{BASE_CONNECTION_ID}/explore?objectType=table&object={TABLE_PATH}
매개 변수 설명
{BASE_CONNECTION_ID} 소스의 기본 연결 ID입니다.
{TABLE_PATH} 검사할 테이블의 경로 속성입니다.

요청

curl -X GET \
  'https://platform.adobe.io/data/foundation/flowservice/connections/5e73e5a2-dc36-45a8-9f16-93c7a43af318/explore?objectType=table&object=acmeSpringCampaign' \
  -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}'

응답

성공적인 응답은 지정된 테이블의 내용 및 구조에 대한 정보를 반환합니다. 각 테이블의 열에 대한 세부 사항은 columns 배열입니다.

{
  "format": "flat",
  "schema": {
    "columns": [
      {
        "name": "TestID",
        "type": "string",
        "xdm": {
          "type": "string"
        }
      },
      {
        "name": "Name",
        "type": "string",
        "xdm": {
          "type": "string"
        }
      },
      {
        "name": "Datefield",
        "type": "string",
        "meta:xdmType": "date-time",
        "xdm": {
          "type": "string",
          "format": "date-time"
        }
      },
      {
        "name": "complaint_type",
        "type": "string",
        "xdm": {
          "type": "string"
        }
      },
      {
        "name": "complaint_description",
        "type": "string",
        "xdm": {
          "type": "string"
        }
      },
      {
        "name": "status",
        "type": "string",
        "xdm": {
          "type": "string"
        }
      },
      {
        "name": "status_change_date",
        "type": "string",
        "meta:xdmType": "date-time",
        "xdm": {
          "type": "string",
          "format": "date-time"
        }
      },
      {
        "name": "city",
        "type": "string",
        "xdm": {
          "type": "string"
        }
      },
      {
        "name": "Datefield2",
        "type": "string",
        "meta:xdmType": "date-time",
        "xdm": {
          "type": "string",
          "format": "date-time"
        }
      }
    ]
  }
}

다음 단계

이 자습서에 따라 데이터 테이블의 구조 및 내용에 대한 정보를 수집했습니다. 또한 Platform에 수집할 테이블의 경로를 검색했습니다. 이 정보를 사용하여 소스 연결 및 데이터 흐름을 만들어 데이터를 플랫폼으로 가져올 수 있습니다. 를 사용하여 소스 연결 및 데이터 흐름을 만드는 방법에 대한 특정 단계는 다음 자습서를 참조하십시오 Flow Service API:

이 페이지에서는