흐름 서비스 API를 사용하여 대상을 파일 기반 대상으로 활성화
Experience Platform 외부에서 파일을 내보낼 때 향상된 사용자 정의 기능에 액세스하려면 향상된 파일 내보내기 기능을 사용하십시오.
- 추가 파일 이름 지정 옵션.
- 향상된 매핑 단계를 통해 내보낸 파일에서 사용자 정의 파일 헤더를 설정하는 기능.
- 을(를) 선택하는 기능 파일 유형 내보낸 파일.
- 내보낸 CSV 데이터 파일의 형식을 사용자 지정하는 기능.
이 기능은 아래에 나열된 6개의 클라우드 스토리지 카드에서 지원됩니다.
이 문서에서는 을(를) 사용하는 데 필요한 워크플로에 대해 설명합니다 플로우 서비스 API Adobe Experience Platform에서 위에 연결된 클라우드 스토리지 위치 중 하나로 적격한 프로필을 내보냅니다.
시작하기 get-started
이 안내서를 사용하려면 Adobe Experience Platform의 다음 구성 요소에 대해 이해하고 있어야 합니다.
- Experience Data Model (XDM) System: 표준화된 프레임워크 Experience Platform 고객 경험 데이터를 구성합니다.
- Segmentation Service: Adobe Experience Platform Segmentation Service 에서 대상을 빌드하고 대상을 생성할 수 있습니다. Adobe Experience Platform (으)로부터 Real-Time Customer Profile 데이터.
- Sandboxes: Experience Platform 단일 파티션을 만드는 가상 샌드박스를 제공합니다. Platform 인스턴스를 별도의 가상 환경으로 전환하여 디지털 경험 애플리케이션을 개발하고 발전시킵니다.
다음 섹션에서는 Platform에서 파일 기반 대상에 데이터를 활성화하기 위해 알아야 하는 추가 정보를 제공합니다.
필요 권한 permissions
프로필을 내보내려면 대상 보기, 대상 활성화, 프로필 보기, 및 세그먼트 보기 액세스 제어 권한. 읽기 액세스 제어 개요 필요한 권한을 얻으려면 제품 관리자에게 문의하십시오.
내보내려면 id, 다음이 필요합니다. ID 그래프 보기 액세스 제어 권한.
샘플 API 호출 읽기 reading-sample-api-calls
이 튜토리얼에서는 요청 형식을 지정하는 방법을 보여 주는 예제 API 호출을 제공합니다. 여기에는 경로, 필수 헤더 및 적절한 형식의 요청 페이로드가 포함됩니다. API 응답에서 반환되는 샘플 JSON도 제공됩니다. 샘플 API 호출에 대한 설명서에 사용되는 규칙에 대한 자세한 내용은 의 섹션을 참조하십시오. 예제 API 호출을 읽는 방법 다음에서 Experience Platform 문제 해결 가이드.
필수 및 선택적 헤더에 대한 값 수집 gather-values-headers
을 호출하기 위해 Platform API, 먼저 다음을 완료해야 합니다. Experience Platform 인증 자습서. 인증 튜토리얼을 완료하면 아래와 같이 모든 Experience Platform API 호출의 필수 헤더 각각에 대한 값이 제공됩니다.
- 인증: 전달자
{ACCESS_TOKEN}
- x-api-key:
{API_KEY}
- x-gw-ims-org-id:
{ORG_ID}
의 리소스 Experience Platform 는 특정 가상 샌드박스로 격리될 수 있습니다. 에 대한 요청에서 Platform API에서는 작업이 수행될 샌드박스의 이름과 ID를 지정할 수 있습니다. 이러한 매개 변수는 선택 사항입니다.
- x-sandbox-name:
{SANDBOX_NAME}
페이로드(POST, PUT, PATCH)가 포함된 모든 요청에는 추가 미디어 유형 헤더가 필요합니다.
- 컨텐츠 유형:
application/json
API 참조 설명서 api-reference-documentation
이 자습서에서 모든 API 작업에 대한 참조 설명서를 함께 찾을 수 있습니다. 다음을 참조하십시오. Adobe Developer 웹 사이트의 흐름 서비스 - 대상 API 설명서. 이 자습서와 API 참조 설명서를 동시에 사용하는 것이 좋습니다.
용어집 glossary
이 API 자습서에서 보게 되는 용어에 대한 설명은 용어집 섹션 API 참조 설명서의
대상자를 내보낼 대상 선택 select-destination
프로필을 내보내는 워크플로우를 시작하기 전에 대상을 내보내려는 대상의 연결 사양 및 흐름 사양 ID를 식별합니다. 아래 표를 참조하십시오.
4fce964d-3f37-408f-9778-e597338a21ee
1a0514a6-33d4-4c7f-aff8-594799c47549
6d6b59bf-fb58-4107-9064-4d246c0e5bb2
752d422f-b16f-4f0d-b1c6-26e448e3b388
be2c3209-53bc-47e7-ab25-145db8b873e1
17be2013-2549-41ce-96e7-a70363bec293
10440537-2a7b-4583-ac39-ed38d4b848e8
cd2fc47e-e838-4f38-a581-8fff2f99b63a
c5d93acb-ea8b-4b14-8f53-02138444ae99
585c15c4-6cbf-4126-8f87-e26bff78b657
36965a81-b1c6-401b-99f8-22508f1e6a26
fd36aaa4-bf2b-43fb-9387-43785eeeb799
이 자습서의 다음 단계에서 다양한 흐름 서비스 엔티티를 구성하려면 이러한 ID가 필요합니다. 흐름 서비스 API에서 연결 사양을 검색할 수 있도록 연결 사양 자체의 일부를 참조하여 특정 엔티티를 설정해야 합니다. 표의 모든 대상에 대한 연결 사양을 검색하는 아래 예를 참조하십시오.
요청
accordion | ||
---|---|---|
검색 connection spec 대상 Amazon S3 | ||
|
응답
accordion | ||
---|---|---|
Amazon S3 - 연결 사양 | ||
|
요청
accordion | ||
---|---|---|
검색 connection spec 대상 Azure Blob Storage | ||
|
응답
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec | ||
|
요청
accordion | ||
---|---|---|
검색 connection spec 대상 Azure Data Lake Gen 2(ADLS Gen2) | ||
|
응답
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec | ||
|
요청
accordion | ||
---|---|---|
검색 connection spec 대상 Data Landing Zone(DLZ) | ||
|
응답
accordion | ||
---|---|---|
Data Landing Zone(DLZ) - Connection spec | ||
|
요청
accordion | ||
---|---|---|
검색 connection spec 대상 Google Cloud Storage | ||
|
응답
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec | ||
|
요청
accordion | ||
---|---|---|
검색 connection spec SFTP용 | ||
|
응답
accordion | ||
---|---|---|
SFTP - Connection spec | ||
|
아래 단계에 따라 클라우드 스토리지 대상으로 대상 내보내기 데이터 흐름을 설정하십시오. 일부 단계의 경우 요청 및 응답은 다양한 클라우드 스토리지 대상 간에 다릅니다. 이러한 경우 페이지의 탭을 사용하여 대상을 연결하고 내보내려는 대상에 대한 요청 및 응답을 검색합니다. 올바른 을(를) 사용하십시오 connection spec
및 flow spec
을(를) 구성하려는 대상에 대해 선택합니다.
소스 연결 만들기 create-source-connection
대상을 내보낼 대상을 결정한 후 소스 연결을 만들어야 합니다. 다음 소스 연결 내부로의 연결을 나타냅니다. Experience Platform 프로필 저장소.
요청
추가 정보를 제공하는 요청 예제에서 인라인 주석이 있는 강조 표시된 줄을 확인합니다. 요청을 선택한 터미널에 복사 붙여넣을 때 인라인 주석을 제거합니다.
code language-shell |
---|
|
응답
code language-json |
---|
|
성공적인 응답은 ID( )를 반환합니다.id
)을 참조하십시오. etag
. 소스 연결 ID는 나중에 데이터 흐름을 만들 때 필요하므로 기록해 두십시오.
기본 연결 만들기 create-base-connection
A 기본 연결 대상에 자격 증명을 안전하게 저장합니다. 대상 유형에 따라 해당 대상에 대해 인증하는 데 필요한 자격 증명이 달라질 수 있습니다. 이러한 인증 매개 변수를 찾으려면 먼저 connection spec
섹션에 설명된 대로 원하는 대상에 대해 대상자를 내보낼 대상 선택 그리고 다음을 살펴보십시오. authSpec
응답. 다음 탭을 참조하십시오. authSpec
지원되는 모든 대상의 속성입니다.
accordion | ||
---|---|---|
Amazon S3 - Connection spec 표시 auth spec | ||
인라인 메모가 있는 강조 표시된 줄을 connection spec 아래 예제 : 파일에서 인증 매개 변수를 찾을 위치에 대한 추가 정보를 제공합니다. connection spec.
|
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec 표시 auth spec | ||
인라인 메모가 있는 강조 표시된 줄을 connection spec 아래 예제 : 파일에서 인증 매개 변수를 찾을 위치에 대한 추가 정보를 제공합니다. connection spec.
|
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec 표시 auth spec | ||
인라인 메모가 있는 강조 표시된 줄을 connection spec 아래 예제 : 파일에서 인증 매개 변수를 찾을 위치에 대한 추가 정보를 제공합니다. connection spec.
|
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone(DLZ) - Connection spec 표시 auth spec | |||||
|
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec 표시 auth spec | ||
인라인 메모가 있는 강조 표시된 줄을 connection spec 아래 예제 : 파일에서 인증 매개 변수를 찾을 위치에 대한 추가 정보를 제공합니다. connection spec.
|
accordion | |||||
---|---|---|---|---|---|
SFTP - Connection spec 표시 auth spec | |||||
인라인 메모가 있는 강조 표시된 줄을 connection spec 아래 예제 : 파일에서 인증 매개 변수를 찾을 위치에 대한 추가 정보를 제공합니다. connection spec.
|
인증 사양에 지정된 속성(예: authSpec
응답에서 아래 예와 같이 각 대상 유형에 맞는 필수 자격 증명으로 기본 연결을 만들 수 있습니다.
요청
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - 액세스 키 및 비밀 키 인증을 통한 기본 연결 요청 | |||||
추가 정보를 제공하는 요청 예제에서 인라인 주석이 있는 강조 표시된 줄을 확인합니다. 요청을 선택한 터미널에 복사 붙여넣을 때 요청에서 인라인 주석을 제거합니다.
|
++Amazon S3 - 가정된 역할 인증을 사용한 기본 연결 요청
note tip |
---|
TIP |
필요한 인증 자격 증명을 얻는 방법에 대한 자세한 내용은 대상에 인증 섹션(Amazon S3 대상 설명서 페이지 참조) |
추가 정보를 제공하는 요청 예제에서 인라인 주석이 있는 강조 표시된 줄을 확인합니다. 요청을 선택한 터미널에 복사 붙여넣을 때 요청에서 인라인 주석을 제거합니다.
code language-shell line-numbers data-start-1 data-line-offset-4 h-17 |
---|
|
+++
응답
accordion | ||
---|---|---|
Amazon S3 기본 연결 응답 | ||
|
요청
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - 기본 연결 요청 | |||||
추가 정보를 제공하는 요청 예제에서 인라인 주석이 있는 강조 표시된 줄을 확인합니다. 요청을 선택한 터미널에 복사 붙여넣을 때 요청에서 인라인 주석을 제거합니다.
|
응답
accordion | ||
---|---|---|
Azure Blob Storage - 기본 연결 응답 | ||
|
요청
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - 기본 연결 요청 | |||||
추가 정보를 제공하는 요청 예제에서 인라인 주석이 있는 강조 표시된 줄을 확인합니다. 요청을 선택한 터미널에 복사 붙여넣을 때 요청에서 인라인 주석을 제거합니다.
|
응답
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - 기본 연결 응답 | ||
|
요청
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone(DLZ) - 기본 연결 요청 | |||||
|
응답
accordion | ||
---|---|---|
Data Landing Zone - 기본 연결 응답 | ||
|
요청
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - 기본 연결 요청 | |||||
추가 정보를 제공하는 요청 예제에서 인라인 주석이 있는 강조 표시된 줄을 확인합니다. 요청을 선택한 터미널에 복사 붙여넣을 때 요청에서 인라인 주석을 제거합니다.
|
응답
accordion | ||
---|---|---|
Google Cloud Storage - 기본 연결 응답 | ||
|
요청
accordion | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
암호가 포함된 SFTP - 기본 연결 요청 | |||||||||||||||||||
추가 정보를 제공하는 요청 예제에서 인라인 주석이 있는 강조 표시된 줄을 확인합니다. 요청을 선택한 터미널에 복사 붙여넣을 때 요청에서 인라인 주석을 제거합니다.
|
accordion | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
SSH 키가 있는 SFTP - 기본 연결 요청 | |||||||||||||||||||
추가 정보를 제공하는 요청 예제에서 인라인 주석이 있는 강조 표시된 줄을 확인합니다. 요청을 선택한 터미널에 복사 붙여넣을 때 요청에서 인라인 주석을 제거합니다.
|
응답
accordion | ||
---|---|---|
SFTP - 기본 연결 응답 | ||
|
내보낸 파일에 암호화 추가
선택적으로 내보낸 파일에 암호화를 추가할 수 있습니다. 이 작업을 수행하려면 encryptionSpecs
. 필수 매개 변수가 강조 표시된 아래 요청 예를 참조하십시오.
code language-json line-numbers data-start-1 data-line-offset-4 h-26-27 |
---|
|
요청
추가 정보를 제공하는 요청 예제에서 인라인 주석이 있는 강조 표시된 줄을 확인합니다. 요청을 선택한 터미널에 복사 붙여넣을 때 인라인 주석을 제거합니다.
code language-shell line-numbers data-start-1 data-line-offset-4 h-19 |
---|
|
응답
code language-json |
---|
|
응답에서 연결 ID를 확인합니다. 이 ID는 대상 연결을 만들 때 다음 단계에서 필요합니다.
대상 연결 만들기 create-target-connection
그런 다음 타겟 연결을 만들어야 합니다. Target 연결 내보낸 대상에 대한 내보내기 매개 변수를 저장합니다. 내보내기 매개 변수에는 내보내기 위치, 파일 형식, 압축 및 기타 세부 사항이 포함됩니다. 예를 들어 CSV 파일의 경우 몇 가지 내보내기 옵션을 선택할 수 있습니다. 지원되는 모든 CSV 내보내기 옵션에 대한 광범위한 정보를 보려면 파일 형식 지정 구성 페이지.
다음을 참조하십시오. targetSpec
대상에 제공된 속성 connection spec
각 대상 유형에 대해 지원되는 속성을 이해합니다. 다음 탭을 참조하십시오. targetSpec
지원되는 모든 대상의 속성입니다.
accordion | ||
---|---|---|
Amazon S3 - Connection spec 대상 연결 매개 변수 표시 | ||
인라인 메모가 있는 강조 표시된 줄을 connection spec 를 찾을 위치에 대한 추가 정보를 제공하는 아래 예 target spec 연결 사양의 매개변수. 아래 예제에서 대상 매개 변수를 확인할 수 있습니다. 아님 대상 내보내기 대상에 적용할 수 있습니다.
|
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec 대상 연결 매개 변수 표시 | ||
인라인 메모가 있는 강조 표시된 줄을 connection spec 를 찾을 위치에 대한 추가 정보를 제공하는 아래 예 target spec 연결 사양의 매개변수. 아래 예제에서 대상 매개 변수를 확인할 수 있습니다. 아님 대상 내보내기 대상에 적용할 수 있습니다.
|
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec 대상 연결 매개 변수 표시 | ||
인라인 메모가 있는 강조 표시된 줄을 connection spec 를 찾을 위치에 대한 추가 정보를 제공하는 아래 예 target spec 연결 사양의 매개변수. 아래 예제에서 대상 매개 변수를 확인할 수 있습니다. 아님 대상 내보내기 대상에 적용할 수 있습니다.
|
accordion | ||
---|---|---|
Data Landing Zone(DLZ) - Connection spec 대상 연결 매개 변수 표시 | ||
인라인 메모가 있는 강조 표시된 줄을 connection spec 를 찾을 위치에 대한 추가 정보를 제공하는 아래 예 target spec 연결 사양의 매개변수. 아래 예제에서 대상 매개 변수를 확인할 수 있습니다. 아님 대상 내보내기 대상에 적용할 수 있습니다.
|
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec 대상 연결 매개 변수 표시 | ||
인라인 메모가 있는 강조 표시된 줄을 connection spec 를 찾을 위치에 대한 추가 정보를 제공하는 아래 예 target spec 연결 사양의 매개변수. 아래 예제에서 대상 매개 변수를 확인할 수 있습니다. 아님 대상 내보내기 대상에 적용할 수 있습니다.
|
accordion | ||
---|---|---|
SFTP - Connection spec 대상 연결 매개 변수 표시 | ||
인라인 메모가 있는 강조 표시된 줄을 connection spec 를 찾을 위치에 대한 추가 정보를 제공하는 아래 예 target spec 연결 사양의 매개변수. 아래 예제에서 대상 매개 변수를 확인할 수 있습니다. 아님 대상 내보내기 대상에 적용할 수 있습니다.
|
위의 사양을 사용하여 아래 탭에 표시된 대로 원하는 클라우드 스토리지 대상에 해당하는 Target 연결 요청을 구성할 수 있습니다.
요청
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Target 연결 요청 | |||||
추가 정보를 제공하는 요청 예제에서 인라인 주석이 있는 강조 표시된 줄을 확인합니다. 요청을 선택한 터미널에 복사 붙여넣을 때 요청에서 인라인 주석을 제거합니다.
|
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - CSV 옵션을 사용하여 Target 연결 요청 | |||||
|
응답
accordion | ||
---|---|---|
Target 연결 - 응답 | ||
|
요청
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - Target 연결 요청 | |||||
추가 정보를 제공하는 요청 예제에서 인라인 주석이 있는 강조 표시된 줄을 확인합니다. 요청을 선택한 터미널에 복사 붙여넣을 때 요청에서 인라인 주석을 제거합니다.
|
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - CSV 옵션을 사용하여 Target 연결 요청 | |||||
|
응답
accordion | ||
---|---|---|
Target 연결 - 응답 | ||
|
요청
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Target 연결 요청 | |||||
추가 정보를 제공하는 요청 예제에서 인라인 주석이 있는 강조 표시된 줄을 확인합니다. 요청을 선택한 터미널에 복사 붙여넣을 때 요청에서 인라인 주석을 제거합니다.
|
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - CSV 옵션을 사용하여 Target 연결 요청 | |||||
|
응답
accordion | ||
---|---|---|
Target 연결 - 응답 | ||
|
요청
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone - Target 연결 요청 | |||||
추가 정보를 제공하는 요청 예제에서 인라인 주석이 있는 강조 표시된 줄을 확인합니다. 요청을 선택한 터미널에 복사 붙여넣을 때 요청에서 인라인 주석을 제거합니다.
|
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone - CSV 옵션을 사용하여 Target 연결 요청 | |||||
|
응답
accordion | ||
---|---|---|
Target 연결 - 응답 | ||
|
요청
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - Target 연결 요청 | |||||
추가 정보를 제공하는 요청 예제에서 인라인 주석이 있는 강조 표시된 줄을 확인합니다. 요청을 선택한 터미널에 복사 붙여넣을 때 요청에서 인라인 주석을 제거합니다.
|
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - CSV 옵션을 사용하여 Target 연결 요청 | |||||
|
응답
accordion | ||
---|---|---|
Target 연결 - 응답 | ||
|
요청
accordion | |||||
---|---|---|---|---|---|
SFTP - Target 연결 요청 | |||||
추가 정보를 제공하는 요청 예제에서 인라인 주석이 있는 강조 표시된 줄을 확인합니다. 요청을 선택한 터미널에 복사 붙여넣을 때 요청에서 인라인 주석을 제거합니다.
|
accordion | |||||
---|---|---|---|---|---|
SFTP - CSV 옵션이 있는 Target 연결 요청 | |||||
|
응답
accordion | ||
---|---|---|
Target 연결 - 응답 | ||
|
다음을 참고하십시오. target connection ID
응답. 이 ID는 대상자를 내보내기 위한 데이터 흐름을 만들 때 다음 단계에서 필수입니다.
성공적인 응답은 ID( )를 반환합니다.id
)을 참조하십시오. etag
. 대상 연결 ID는 나중에 데이터 흐름을 만들 때 필요하므로 기록해 두십시오.
데이터 흐름 만들기 create-dataflow
대상 구성의 다음 단계는 데이터 흐름을 만드는 것입니다. A 데이터 흐름 는 이전에 만든 엔티티를 결합하고 대상 내보내기 일정을 구성하는 옵션을 제공합니다. 데이터 흐름을 만들려면 원하는 클라우드 스토리지 대상에 따라 아래 페이로드를 사용하고 이전 단계의 흐름 엔티티 ID를 바꾸십시오. 이 단계에서는 속성 또는 ID 매핑과 관련된 정보를 데이터 흐름에 추가하지 않습니다. 이 작업은 다음 단계에서 수행합니다.
요청
accordion | ||
---|---|---|
대상 내보내기 데이터 흐름 만들기 Amazon S3 대상 - 요청 | ||
추가 정보를 제공하는 요청 예제에서 인라인 주석이 있는 강조 표시된 줄을 확인합니다. 요청을 선택한 터미널에 복사 붙여넣을 때 요청에서 인라인 주석을 제거합니다.
|
응답
accordion | ||
---|---|---|
데이터 흐름 만들기 - 응답 | ||
|
요청
accordion | ||
---|---|---|
대상 내보내기 데이터 흐름 만들기 Azure Blob Storage 대상 - 요청 | ||
추가 정보를 제공하는 요청 예제에서 인라인 주석이 있는 강조 표시된 줄을 확인합니다. 요청을 선택한 터미널에 복사 붙여넣을 때 요청에서 인라인 주석을 제거합니다.
|
응답
accordion | ||
---|---|---|
데이터 흐름 만들기 - 응답 | ||
|
요청
accordion | ||
---|---|---|
대상 내보내기 데이터 흐름 만들기 Azure Data Lake Gen 2(ADLS Gen2) 대상 - 요청 | ||
추가 정보를 제공하는 요청 예제에서 인라인 주석이 있는 강조 표시된 줄을 확인합니다. 요청을 선택한 터미널에 복사 붙여넣을 때 요청에서 인라인 주석을 제거합니다.
|
응답
accordion | ||
---|---|---|
데이터 흐름 만들기 - 응답 | ||
|
요청
accordion | ||
---|---|---|
대상 내보내기 데이터 흐름 만들기 Data Landing Zone 대상 - 요청 | ||
추가 정보를 제공하는 요청 예제에서 인라인 주석이 있는 강조 표시된 줄을 확인합니다. 요청을 선택한 터미널에 복사 붙여넣을 때 요청에서 인라인 주석을 제거합니다.
|
응답
accordion | ||
---|---|---|
데이터 흐름 만들기 - 응답 | ||
|
요청
accordion | ||
---|---|---|
대상 내보내기 데이터 흐름 만들기 Google Cloud Storage 대상 - 요청 | ||
추가 정보를 제공하는 요청 예제에서 인라인 주석이 있는 강조 표시된 줄을 확인합니다. 요청을 선택한 터미널에 복사 붙여넣을 때 요청에서 인라인 주석을 제거합니다.
|
응답
accordion | ||
---|---|---|
데이터 흐름 만들기 - 응답 | ||
|
요청
accordion | ||
---|---|---|
SFTP 대상으로 대상 내보내기 데이터 흐름 만들기 - 요청 | ||
추가 정보를 제공하는 요청 예제에서 인라인 주석이 있는 강조 표시된 줄을 확인합니다. 요청을 선택한 터미널에 복사 붙여넣을 때 요청에서 인라인 주석을 제거합니다.
|
응답
accordion | ||
---|---|---|
데이터 흐름 만들기 - 응답 | ||
|
응답에서 데이터 흐름 ID를 확인합니다. 이 ID는 이후 단계에서 필수입니다.
내보내기에 대상자 추가
이 단계에서는 대상으로 내보낼 대상을 선택할 수도 있습니다. 이 단계와 데이터 흐름에 대상을 추가하는 요청 형식에 대한 자세한 내용은 대상 데이터 흐름 업데이트 섹션에 자세히 설명되어 있습니다.
속성 및 ID 매핑 설정 attribute-and-identity-mapping
데이터 흐름을 만든 후 내보낼 속성 및 ID에 대한 매핑을 설정해야 합니다. 이 단계는 아래에 나열된 세 단계로 구성됩니다.
- 입력 스키마 만들기
- 출력 스키마 만들기
- 생성된 스키마를 연결하도록 매핑 세트 설정
예를 들어 UI에 표시된 다음 매핑을 가져오려면 위에 나열되고 다음 제목에 자세히 설명된 세 단계를 거쳐야 합니다.
입력 스키마 만들기
입력 스키마를 생성하려면 먼저 유니온 스키마 및 대상을 내보낼 수 있는 ID입니다. 소스 매핑으로 선택할 수 있는 속성 및 ID의 스키마입니다.
속성 및 ID를 검색하기 위한 요청 및 응답의 아래 예를 보십시오.
속성 가져오기 요청
code language-shell |
---|
|
응답
간결성을 위해 아래 응답이 짧아졌습니다.
code language-json |
---|
|
ID 가져오기 요청
code language-shell |
---|
|
응답
이 응답은 입력 스키마를 만들 때 사용할 수 있는 ID를 반환합니다. 이 응답은 두 가지를 모두 반환합니다. 표준 및 사용자 정의 Experience Platform에서 설정한 id 네임스페이스.
code language-json |
---|
|
다음으로, 위의 응답을 복사하여 입력 스키마를 만드는 데 사용해야 합니다. 위의 응답에서 전체 JSON 응답을 복사하여 jsonSchema
아래에 표시된 개체입니다.
입력 스키마 만들기 요청
code language-shell |
---|
|
응답
code language-json |
---|
|
응답의 ID는 생성한 입력 스키마의 고유 식별자를 나타냅니다. 이후 단계에서 재사용할 예정이므로 응답에서 ID를 복사합니다.
출력 스키마 만들기
그런 다음 내보내기를 위해 출력 스키마를 설정해야 합니다. 먼저 기존 파트너 스키마를 찾아 검사해야 합니다.
요청
아래 예제에서는 connection spec ID
Amazon S3용 이 값을 대상에 대한 연결 사양 ID로 바꾸십시오.
code language-shell |
---|
|
예제 스키마가 있는 응답
Inspect 위의 호출을 수행할 때 받는 응답입니다. 응답을 드릴다운하여 객체를 찾아야 합니다 targetSpec.attributes.partnerSchema.jsonSchema
code language-json |
---|
|
그런 다음 출력 스키마를 만들어야 합니다. 위에 표시된 JSON 응답을 복사하여 jsonSchema
아래에 있는 개체입니다.
요청
code language-shell |
---|
|
응답
code language-json |
---|
|
응답의 ID는 생성한 입력 스키마의 고유 식별자를 나타냅니다. 이후 단계에서 재사용할 예정이므로 응답에서 ID를 복사합니다.
매핑 세트 만들기 create-mapping-set
그런 다음 를 사용합니다. 데이터 준비 API 입력 스키마 ID, 출력 스키마 ID 및 원하는 필드 매핑을 사용하여 매핑 세트를 만듭니다.
요청
note important |
---|
IMPORTANT |
|
code language-shell line-numbers data-start-1 data-line-offset-4 h-16-38 |
---|
|
응답
code language-json |
---|
|
매핑 세트 ID로 기존 데이터 흐름을 업데이트하려면 다음 단계에서 필요하므로 매핑 세트의 ID를 참고하십시오.
그런 다음 업데이트할 데이터 흐름의 ID를 가져옵니다.
다음을 참조하십시오 대상 데이터 흐름의 세부 정보 검색 데이터 흐름의 ID 검색에 대한 정보입니다.
마지막으로 방금 만든 매핑 세트 정보로 데이터 흐름을 PATCH 해야 합니다.
요청
code language-shell |
---|
|
응답
흐름 서비스 API의 응답은 업데이트된 데이터 흐름의 ID를 반환합니다.
code language-json |
---|
|
다른 데이터 흐름 업데이트 other-dataflow-updates
데이터 흐름을 업데이트하려면 PATCH
예를들어 데이터 흐름을 업데이트하여 필드를 필수 키 또는 중복 제거 키로 선택할 수 있습니다.
필수 키 추가 add-mandatory-key
을(를) 추가하려면 필수 키, 아래의 요청 및 응답 예 를 참조하십시오
요청
code language-shell |
---|
|
code language-shell |
---|
|
응답
code language-json |
---|
|
중복 제거 키 추가 add-deduplication-key
을(를) 추가하려면 중복 제거 키, 아래의 요청 및 응답 예 를 참조하십시오
요청
code language-shell |
---|
|
code language-shell |
---|
|
응답
code language-json |
---|
|
데이터 흐름 유효성 검사(데이터 흐름 실행 가져오기) get-dataflow-runs
데이터 흐름 실행을 확인하려면 데이터 흐름 실행 API를 사용하십시오.
요청
code language-shell |
---|
|
응답
code language-json |
---|
|
다음에 대한 정보를 찾을 수 있습니다. 데이터 흐름에서 반환된 다양한 매개 변수는 API를 실행합니다. API 참조 설명서에서 참조하십시오.
API 오류 처리 api-error-handling
이 자습서의 API 끝점은 일반적인 Experience Platform API 오류 메시지 원칙을 따릅니다. 을(를) 참조하십시오 API 상태 코드 및 요청 헤더 오류 오류 응답 해석에 대한 자세한 내용은 플랫폼 문제 해결 안내서를 참조하십시오.
다음 단계 next-steps
이 자습서에 따라 선호하는 클라우드 스토리지 대상 중 하나에 플랫폼을 연결하고 대상을 내보내도록 각 대상에 데이터 흐름을 설정했습니다. 흐름 서비스 API를 사용하여 기존 데이터 흐름을 편집하는 방법과 같은 자세한 내용은 다음 페이지를 참조하십시오.