Flow Service API를 사용하여 MySQL을(를) Experience Platform에 연결
작성 대상:
- 개발자
Flow Service API를 사용하여 MySQL 계정을 Adobe Experience Platform에 연결하는 방법을 알아보려면 이 안내서를 참조하십시오.
시작하기
이 안내서를 사용하려면 Adobe Experience Platform의 다음 구성 요소에 대해 이해하고 있어야 합니다.
다음 섹션에서는 Flow Service API를 사용하여 MySQL에 성공적으로 연결하기 위해 알아야 할 추가 정보를 제공합니다.
필요한 자격 증명 수집
인증에 대한 자세한 내용은 MySQL 개요를 읽어 보십시오.
Experience Platform API 사용
Experience Platform API를 성공적으로 호출하는 방법에 대한 자세한 내용은 Experience Platform API 시작하기의 안내서를 참조하십시오.
Azure에서 MySQL을(를) Experience Platform에 연결
MySQL 계정을 Azure의 Experience Platform에 연결하는 방법에 대한 자세한 내용은 아래 단계를 참조하세요.
Azure의 Experience Platform에서 MySQL에 대한 기본 연결 만들기
기본 연결은 소스를 Experience Platform에 연결하여 인증 세부 정보, 연결 상태 및 고유 ID를 저장합니다. 이 ID를 사용하여 소스 파일을 검색하고 데이터 유형 및 형식을 포함하여 수집할 특정 항목을 식별합니다.
API 형식
POST /connections
기본 연결 ID를 만들려면 /connections
끝점에 POST를 요청하고 MySQL 인증 자격 증명을 요청 매개 변수의 일부로 제공합니다.
요청
다음 요청은 연결 문자열 기반 인증을 사용하여 MySQL에 대한 기본 연결을 만듭니다.
요청 보기 예
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": "MySQL Base Connection to Experience Platform",
"description": "Via Connection String,
"auth": {
"specName": "Connection String Based Authentication",
"params": {
"connectionString": "Server={SERVER};Port={PORT};Database={DATABASE};UID={USERNAME};PWD={PASSWORD}"
}
},
"connectionSpec": {
"id": "26d738e0-8963-47ea-aadf-c60de735468a",
"version": "1.0"
}
}'
auth.params.connectionString
Server={SERVER};Port={PORT};Database={DATABASE};UID={USERNAME};PWD={PASSWORD}
입니다.connectionSpec.id
26d738e0-8963-47ea-aadf-c60de735468a
.응답
성공한 응답은 고유 식별자(id
)를 포함하여 새로 만든 기본 연결의 세부 정보를 반환합니다.
{
"id": "1a444165-3439-4c16-8441-653439dc166a",
"etag": "\"5b04c219-0000-0200-0000-5e179c8f0000\""
}
요청
다음 요청은 기본 인증을 사용하여 MySQL 소스에 대한 기본 연결을 만듭니다.
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": "MySQL Base Connection to Experience Platform",
"description": "Via Basic Authentication",
"auth": {
"specName": "Basic Authentication",
"params": {
"server": "localhost",
"port": "443",
"database": "mysql-acme",
"username": "acme",
"password": "xxxx",
"sslMode": "DISABLED"
}
},
"connectionSpec": {
"id": "26d738e0-8963-47ea-aadf-c60de735468a",
"version": "1.0"
}
}'
auth.params.server
auth.params.database
auth.params.username
auth.params.password
auth.params.sslMode
connectionSpec.id
26d738e0-8963-47ea-aadf-c60de735468a
.응답
성공한 응답은 고유 식별자(id
)를 포함하여 새로 만든 기본 연결의 세부 정보를 반환합니다.
{
"id": "025d4158-4113-403b-b551-e81724d3880c",
"etag": "\"ae004437-0000-0200-0000-67ee107e0000\""
}
Amazon Web Services에서 MySQL을(를) Experience Platform에 연결
MySQL 계정을 AWS의 Experience Platform에 연결하는 방법에 대한 자세한 내용은 아래 단계를 참조하십시오.
AWS의 Experience Platform에서 MySQL에 대한 기본 연결 만들기
API 형식
POST /connections
요청
다음 요청은 MySQL이(가) AWS의 Experience Platform에 연결할 수 있는 기본 연결을 만듭니다.
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": "MySQL on Experience Platform AWS",
"description": "MySQL on Experience Platform AWS",
"auth": {
"specName": "Basic Authentication",
"params": {
"server": "localhost",
"port": "443",
"database": "mysql-acme",
"username": "acme",
"password": "xxxx",
"sslMode": "false"
}
},
"connectionSpec": {
"id": "26d738e0-8963-47ea-aadf-c60de735468a",
"version": "1.0"
}
}'
auth.params.server
auth.params.database
auth.params.username
auth.params.password
auth.params.sslMode
false
입니다.connectionSpec.id
26d738e0-8963-47ea-aadf-c60de735468a
.응답
성공한 응답은 고유 식별자(id
)를 포함하여 새로 만든 기본 연결의 세부 정보를 반환합니다.
{
"id": "f847950c-1c12-4568-a550-d5312b16fdb8",
"etag": "\"0c0099f4-0000-0200-0000-67da91710000\""
}
MySQL 데이터에 대한 데이터 흐름 만들기
MySQL 데이터베이스를 연결했으므로 이제 데이터 흐름을 만들고 데이터베이스에서 Experience Platform으로 데이터를 수집할 수 있습니다.