다음 Snowflake 소스는 Real-time Customer Data Platform Ultimate를 구매한 사용자에게 소스 카탈로그에서 사용할 수 있습니다.
기본 연결은 소스와 Adobe Experience Platform 간의 인증된 연결을 나타냅니다.
이 자습서에서는 기본 연결을 만드는 단계를 안내합니다. Snowflake 사용 [Flow Service API] (https://www.adobe.io/experience-platform-apis/references/flow-service/).
이 안내서를 사용하려면 Adobe Experience Platform의 다음 구성 요소에 대해 이해하고 있어야 합니다.
Platform API를 성공적으로 호출하는 방법에 대한 자세한 내용은 의 안내서를 참조하십시오. platform API 시작하기.
다음 섹션에서는 에 성공적으로 연결하기 위해 알아야 하는 추가 정보를 제공합니다 Snowflake 사용 Flow Service API.
주문 Flow Service 연결 대상 Snowflake, 다음 연결 속성을 제공해야 합니다.
자격 증명 | 설명 |
---|---|
account |
와(과) 연결된 전체 계정 이름 Snowflake 계정입니다. 완전한 자격을 갖춘 Snowflake 계정 이름에는 계정 이름, 지역 및 클라우드 플랫폼이 포함됩니다. 예, cj12345.east-us-2.azure . 계정 이름에 대한 자세한 내용은 다음을 참조하십시오. Snowflake document on account identifiers. |
warehouse |
다음 Snowflake warehouse는 애플리케이션의 쿼리 실행 프로세스를 관리합니다. 각 Snowflake warehouse는 서로 독립적이며 데이터를 Platform으로 가져올 때 개별적으로 액세스해야 합니다. |
database |
다음 Snowflake 데이터베이스에는 플랫폼으로 가져올 데이터가 포함되어 있습니다. |
username |
의 사용자 이름 Snowflake 계정입니다. |
password |
에 대한 암호 Snowflake 사용자 계정입니다. |
role |
에서 사용할 기본 액세스 제어 역할 Snowflake 세션. 역할은 지정된 사용자에게 이미 할당된 기존 역할이어야 합니다. 기본 역할은 입니다. PUBLIC . |
connectionString |
에 연결하는 데 사용되는 연결 문자열 Snowflake 인스턴스. 에 대한 연결 문자열 패턴입니다 Snowflake 은(는) jdbc:snowflake://{ACCOUNT_NAME}.snowflakecomputing.com/?user={USERNAME}&password={PASSWORD}&db={DATABASE}&warehouse={WAREHOUSE} |
connectionSpec.id |
연결 사양은 기본 및 소스 연결 만들기와 관련된 인증 사양을 포함하여 소스의 커넥터 속성을 반환합니다. 에 대한 연결 사양 ID Snowflake 은(는) b2e08744-4f1a-40ce-af30-7abac3e23cf3 . |
시작에 대한 자세한 내용은 다음을 참조하십시오. Snowflake 문서.
다음을 설정해야 합니다. PREVENT_UNLOAD_TO_INLINE_URL
플래그 지정 대상 FALSE
에서 데이터 언로드를 허용하려면 Snowflake Experience Platform 대상 데이터베이스.
기본 연결은 소스의 인증 자격 증명, 연결의 현재 상태 및 고유한 기본 연결 ID를 포함하여 소스와 플랫폼 간에 정보를 유지합니다. 기본 연결 ID를 사용하면 소스 내에서 파일을 탐색 및 탐색하고 데이터 유형 및 형식에 대한 정보를 포함하여 수집할 특정 항목을 식별할 수 있습니다.
POST 기본 연결 ID를 만들려면 /connections
을(를) 제공하는 동안 엔드포인트 Snowflake 요청 본문의 일부인 인증 자격 증명입니다.
API 형식
POST /connections
요청
다음 요청은에 대한 기본 연결을 만듭니다. Snowflake:
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": "Snowflake base connection",
"description": "Snowflake base connection",
"auth": {
"specName": "ConnectionString",
"params": {
"connectionString": "jdbc:snowflake://{ACCOUNT_NAME}.snowflakecomputing.com/?user={USERNAME}&password={PASSWORD}&db={DATABASE}&warehouse={WAREHOUSE}"
}
},
"connectionSpec": {
"id": "b2e08744-4f1a-40ce-af30-7abac3e23cf3",
"version": "1.0"
}
}'
속성 | 설명 |
---|---|
auth.params.connectionString |
에 연결하는 데 사용되는 연결 문자열 Snowflake 인스턴스. 에 대한 연결 문자열 패턴입니다 Snowflake 은(는) jdbc:snowflake://{ACCOUNT_NAME}.snowflakecomputing.com/?user={USERNAME}&password={PASSWORD}&db={DATABASE}&warehouse={WAREHOUSE} . |
connectionSpec.id |
다음 Snowflake 연결 사양 ID: b2e08744-4f1a-40ce-af30-7abac3e23cf3 . |
응답
성공한 응답은 고유 연결 식별자( )를 포함하여 새로 생성된 연결을 반환합니다.id
). 이 ID는 다음 자습서에서 데이터를 탐색하는 데 필요합니다.
{
"id": "2fce94c1-9a93-4971-8e94-c19a93097129",
"etag": "\"d403848a-0000-0200-0000-5e978f7b0000\""
}
이 자습서를 따라 Snowflake 를 사용한 기본 연결 Flow Service API. 다음 자습서에서 이 기본 연결 ID를 사용할 수 있습니다.