다음 Google BigQuery 소스는 Real-time Customer Data Platform Ultimate를 구매한 사용자에게 소스 카탈로그에서 사용할 수 있습니다.
기본 연결은 소스와 Adobe Experience Platform 간의 인증된 연결을 나타냅니다.
이 자습서에서는 기본 연결을 만드는 단계를 안내합니다. Google BigQuery 사용 Flow Service API.
이 안내서를 사용하려면 Experience Platform의 다음 구성 요소에 대해 이해하고 있어야 합니다.
다음 섹션에서는 에 성공적으로 연결하기 위해 알아야 하는 추가 정보를 제공합니다 Google BigQuery 사용 Flow Service API.
주문 Flow Service 연결하려면 Google BigQuery 플랫폼에 다음 OAuth 2.0 인증 값을 제공해야 합니다.
자격 증명 | 설명 |
---|---|
project |
기본값의 프로젝트 ID Google BigQuery 쿼리할 프로젝트입니다. |
clientID |
새로 고침 토큰을 생성하는 데 사용되는 ID 값입니다. |
clientSecret |
새로 고침 토큰을 생성하는 데 사용되는 비밀 값. |
refreshToken |
다음에서 얻은 새로 고침 토큰: Google 에 대한 액세스 권한을 부여하는 데 사용됨 Google BigQuery. |
largeResultsDataSetId |
사전 생성됨 Google BigQuery 대용량 결과 세트에 대한 지원을 활성화하는 데 필요한 데이터 세트 ID입니다. |
connectionSpec.id |
연결 사양은 기본 및 소스 연결 만들기와 관련된 인증 사양을 포함하여 소스의 커넥터 속성을 반환합니다. 에 대한 연결 사양 ID Google BigQuery 은(는) 3c9b37f8-13a6-43d8-bad3-b863b941fedd . |
이러한 값에 대한 자세한 내용은 다음을 참조하십시오 Google BigQuery 문서.
Platform API를 성공적으로 호출하는 방법에 대한 자세한 내용은 의 안내서를 참조하십시오. platform API 시작하기.
기본 연결은 소스의 인증 자격 증명, 연결의 현재 상태 및 고유한 기본 연결 ID를 포함하여 소스와 플랫폼 간에 정보를 유지합니다. 기본 연결 ID를 사용하면 소스 내에서 파일을 탐색 및 탐색하고 데이터 유형 및 형식에 대한 정보를 포함하여 수집할 특정 항목을 식별할 수 있습니다.
POST 기본 연결 ID를 만들려면 /connections
을(를) 제공하는 동안 엔드포인트 Google BigQuery 요청 매개 변수의 일부로 인증 자격 증명을 사용합니다.
API 형식
POST /connections
요청
다음 요청은에 대한 기본 연결을 만듭니다. Google BigQuery:
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": "Google BigQuery connection",
"description": "Google BigQuery connection",
"auth": {
"specName": "Basic Authentication",
"type": "OAuth2.0",
"params": {
"project": "{PROJECT}",
"clientId": "{CLIENT_ID},
"clientSecret": "{CLIENT_SECRET}",
"refreshToken": "{REFRESH_TOKEN}"
}
},
"connectionSpec": {
"id": "3c9b37f8-13a6-43d8-bad3-b863b941fedd",
"version": "1.0"
}
}'
속성 | 설명 |
---|---|
auth.params.project |
기본값의 프로젝트 ID Google BigQuery 쿼리할 프로젝트입니다. 에 대해. |
auth.params.clientId |
새로 고침 토큰을 생성하는 데 사용되는 ID 값입니다. |
auth.params.clientSecret |
새로 고침 토큰을 생성하는 데 사용되는 클라이언트 값입니다. |
auth.params.refreshToken |
다음에서 얻은 새로 고침 토큰: Google 에 대한 액세스 권한을 부여하는 데 사용됨 Google BigQuery. |
connectionSpec.id |
다음 Google BigQuery 연결 사양 ID: 3c9b37f8-13a6-43d8-bad3-b863b941fedd . |
응답
성공한 응답은 고유 식별자를 포함하여 새로 생성된 연결의 세부 정보를 반환합니다(id
). 이 ID는 다음 자습서에서 데이터를 탐색하는 데 필요합니다.
{
"id": "6990abad-977d-41b9-a85d-17ea8cf1c0e4",
"etag": "\"ca00acbf-0000-0200-0000-60149e1e0000\""
}
이 자습서를 따라 Google BigQuery 를 사용한 기본 연결 Flow Service API. 다음 자습서에서 이 기본 연결 ID를 사용할 수 있습니다.