자격 증명 안내서
Adobe Experience Platform Query Service를 사용하면 외부 클라이언트와 연결할 수 있습니다. 만료 자격 증명 또는 만료되지 않는 자격 증명을 사용하여 이러한 외부 클라이언트에 연결할 수 있습니다.
자격 증명 만료 expiring-credentials
만료되는 자격 증명을 사용하여 외부 클라이언트에 대한 연결을 빠르게 설정할 수 있습니다.
자격 증명 만료 섹션에서 다음 정보를 제공합니다.
- 호스트: 클라이언트를 연결할 호스트의 이름입니다. Platform UI의 상단 리본에 표시된 조직 이름이 통합됩니다.
- 포트: 연결할 호스트의 포트 번호입니다.
- 데이터베이스: 클라이언트를 연결할 데이터베이스의 이름입니다.
- 사용자 이름: 쿼리 서비스에 연결하는 데 사용되는 사용자 이름입니다.
- 암호: 쿼리 서비스에 연결하는 데 사용되는 암호입니다. 보안을 위해 UI의 암호가 해시되었습니다. 복사 아이콘( ) 해시되지 않은 전체 자격 증명을 클립보드에 복사합니다.
- PSQL 명령: 명령줄에서 PSQL을 사용하여 쿼리 서비스에 연결할 수 있도록 관련 정보를 모두 자동으로 삽입한 명령입니다.
- 만료: 만료되는 자격 증명의 만료 날짜 및 시간입니다. 토큰의 기본 유효 기간은 24시간이지만 Admin Console의 고급 설정에서 변경할 수 있습니다.
쿼리 세션 내의 Customer Journey Analytics 데이터에 연결 connect-to-customer-journey-analytics
Power BI 또는 타블로와 함께 Customer Journey Analytics BI 확장을 사용하여 SQL로 Customer Journey Analytics 데이터 보기에 액세스합니다. Query Service를 BI 확장과 통합하여 Query Service 세션 내에서 직접 데이터 보기에 액세스할 수 있습니다. 이 통합은 쿼리 서비스를 PostgreSQL 인터페이스로 사용하는 BI 도구의 기능을 간소화합니다. 이 기능을 사용하면 BI 도구에서 데이터 보기를 복제할 필요가 없고, 플랫폼 간에 일관된 보고를 보장하며, Customer Journey Analytics 데이터를 BI 플랫폼의 다른 소스와 간편하게 통합할 수 있습니다.
쿼리 서비스를 다양한 데스크톱 클라이언트 응용 프로그램에 연결(예: Power BI 또는 타블로)하는 방법에 대해 알아보려면 설명서를 참조하세요.
Power BI 또는 Tableau에서 Customer Journey Analytics 데이터에 액세스하려면 데이터베이스 드롭다운 메뉴를 선택한 다음 사용 가능한 옵션에서 prod:cja
을(를) 선택하십시오. 그런 다음 Power BI 또는 Tableau 구성에서 사용할 Postgres 자격 증명 매개 변수(호스트, 포트, 데이터베이스, 사용자 이름 등)를 복사합니다.
쿼리 편집기 또는 Postgres CLI에서 직접 Customer Journey Analytics 데이터에 액세스할 수도 있습니다. 이렇게 하려면 쿼리를 작성할 때 cja
데이터베이스를 참조하십시오. 쿼리 작성, 실행 및 저장 방법에 대한 자세한 내용은 쿼리 편집기 쿼리 작성 안내서를 참조하십시오.
SQL을 사용하여 Customer Journey Analytics 데이터 보기에 액세스하는 방법에 대한 자세한 지침은 BI 확장 안내서를 참조하십시오.
만료되지 않는 자격 증명 non-expiring-credentials
만료되지 않는 자격 증명을 사용하여 외부 클라이언트에 대한 보다 영구적인 연결을 설정할 수 있습니다.
- 사용자는 사용자 이름과 암호를 사용하여
{technicalAccountId}:{credential}
형식으로 로그인해야 합니다. 자세한 내용은 자격 증명 생성 섹션에서 확인할 수 있습니다. - 기본적으로 만료되지 않는 자격 증명에는
SELECT
개의 쿼리만 실행할 수 있는 권한이 부여됩니다.CTAS
또는ITAS
쿼리를 실행하려면 만료되지 않는 자격 증명과 연결된 역할에 "데이터 집합 관리" 및 "스키마 관리" 권한을 수동으로 추가하십시오. "스키마 관리" 권한은 "데이터 모델링" 섹션에서 찾을 수 있으며 "데이터 세트 관리" 권한은 [Adobe Developer Console] (https://developer.adobe.com/console/)의 "데이터 관리" 섹션 아래에 있습니다. - 서드파티 클라이언트는 쿼리 개체를 나열할 때 예상과 다르게 수행할 수 있습니다. 예를 들어 DB Visualizer 같은 일부 타사 클라이언트는 왼쪽 패널에 보기 이름을 표시하지 않습니다. 그러나
SELECT
쿼리 내에서 호출되는 경우 보기 이름에 액세스할 수 있습니다. 마찬가지로 PowerUI은(는) 대시보드 만들기에서 선택할 SQL을 통해 만든 임시 보기를 나열하지 않을 수 있습니다.
전제 조건
만료되지 않는 자격 증명을 생성하려면 Adobe Admin Console에서 다음 단계를 완료해야 합니다.
- Adobe Admin Console에 로그인한 다음 상단 탐색 모음에서 관련 조직을 선택합니다.
- 제품 프로필을 선택합니다.
- 제품 프로필에 대해 샌드박스 및 쿼리 서비스 통합 관리 권한을 모두 구성합니다.
- 새 사용자를 제품 프로필에 추가하여 구성된 사용 권한을 부여합니다.
- 사용자를 제품 프로필 관리자로 추가하여 활성 제품 프로필에 대한 계정 만들기를 허용합니다.
- 통합을 만들려면 사용자를 제품 프로필 개발자로 추가하십시오.
권한을 할당하는 방법에 대한 자세한 내용은 액세스 제어에 대한 설명서를 참조하십시오.
이제 사용자가 만료되는 자격 증명 기능을 사용할 수 있도록 Adobe Developer Console에 필요한 모든 권한이 구성됩니다.
자격 증명 생성 generate-credentials
만료되지 않는 자격 증명 집합을 만들려면 Platform UI로 돌아가서 왼쪽 탐색에서 쿼리 를 선택하여 쿼리 작업 영역에 액세스합니다. 자격 증명 탭 다음에 자격 증명 생성 을 선택합니다.
자격 증명을 생성할 수 있는 대화 상자가 나타납니다. 만료되지 않는 자격 증명을 만들려면 다음 세부 정보를 제공해야 합니다.
- 이름: 생성 중인 자격 증명의 이름입니다.
- 설명: (선택 사항) 생성 중인 자격 증명에 대한 설명입니다.
- 할당 대상: 자격 증명을 할당할 사용자입니다. 이 값은 자격 증명을 만드는 사용자의 이메일 주소여야 합니다.
- 암호(선택 사항) 자격 증명의 선택적 암호입니다. 암호를 설정하지 않으면 Adobe이 자동으로 암호를 생성합니다.
필요한 모든 세부 정보를 제공했으면 자격 증명 생성 을 선택하여 자격 증명을 생성합니다.
구성 JSON 파일에는 기술 계정 이름, 기술 계정 ID 및 자격 증명과 같은 정보가 포함되어 있습니다. 다음 형식으로 제공됩니다.
{"technicalAccountName":"9F0A21EE-B8F3-4165-9871-846D3C8BC49E@TECHACCT.ADOBE.COM","credential":"3d184fa9e0b94f33a7781905c05203ee","technicalAccountId":"4F2611B8613AA3670A495E55"}
생성된 자격 증명을 저장한 후 닫기 를 선택합니다. 이제 만료되지 않는 모든 자격 증명 목록을 볼 수 있습니다.
만료되지 않는 자격 증명을 편집하거나 삭제할 수 있습니다. 만료되지 않는 자격 증명을 편집하려면 연필 아이콘( ). 만료되지 않는 자격 증명을 삭제하려면 삭제 아이콘( )을 선택하십시오.
만료되지 않는 자격 증명을 편집할 때 모달이 표시됩니다. 업데이트할 다음 세부 정보를 제공할 수 있습니다.
- 이름: 생성 중인 자격 증명의 이름입니다.
- 설명: (선택 사항) 생성 중인 자격 증명에 대한 설명입니다.
- 할당 대상: 자격 증명을 할당할 사용자입니다. 이 값은 자격 증명을 만드는 사용자의 이메일 주소여야 합니다.
필요한 모든 세부 정보를 제공했으면 계정 업데이트 를 선택하여 자격 증명 업데이트를 완료합니다.
자격 증명을 사용하여 외부 클라이언트에 연결 use-credential-to-connect
만료 전 또는 만료되지 않는 자격 증명을 사용하여 Aqua Data Studio, Looker 또는 Power BI 같은 외부 클라이언트와 연결할 수 있습니다. 이러한 자격 증명에 대한 입력 방법은 외부 클라이언트에 따라 달라집니다. 이러한 자격 증명 사용에 대한 특정 지침은 외부 클라이언트의 설명서를 참조하십시오.
이 이미지는 만료되지 않는 자격 증명의 암호를 제외하고 UI에서 발견된 각 매개 변수의 위치를 나타냅니다. 만료되지 않는 자격 증명은 JSON 구성 파일에서 제공되지만, UI의 자격 증명 탭에서 만료되는 자격 증명을 볼 수 있습니다.
아래 표에는 일반적으로 외부 클라이언트에 연결하는 데 필요한 매개 변수가 나와 있습니다.
사용자 이름과 암호를 입력하는 형식은 이 예제
username:{your_username}
및 password:{password_string}
과(와) 같이 콜론으로 구분된 값을 사용합니다.접속 중인 서버/호스트의 이름입니다.
- 이 값은 만료 중인 자격 증명과 만료되지 않는 자격 증명 모두에 사용되며
server.adobe.io
형식을 사용합니다. 만료 자격 증명 섹션의 호스트 에서 값을 찾았습니다.
acme.platform.adobe.io
연결 중인 서버/호스트의 포트입니다.
- 이 값은 만료되는 자격 증명과 만료되지 않는 자격 증명 모두에 사용되며 만료되는 자격 증명 섹션의 포트 에서 찾을 수 있습니다.
80
연결 중인 데이터베이스입니다.
- 이 값은 만료되는 자격 증명과 만료되지 않는 자격 증명 모두에 사용되며 만료되는 자격 증명 섹션의 데이터베이스 에 있습니다.
prod:all
외부 클라이언트에 연결하는 사용자의 사용자 이름입니다.
- 이 값은 만료되는 자격 증명과 만료되지 않는 자격 증명 모두에 사용됩니다.
@AdobeOrg
앞에 영숫자 문자열 형식을 사용합니다. 이 값은 사용자 이름 에 있습니다.
ECBB80245ECFC73E8A095EC9@AdobeOrg
외부 클라이언트에 연결하는 사용자의 암호입니다.
- 만료되는 자격 증명을 사용하는 경우 만료되는 자격 증명 섹션의 암호 에서 찾을 수 있습니다.
- 만료되지 않는 자격 증명을 사용하는 경우 이 값은 technicalAccountID의 연결된 인수와 구성 JSON 파일에서 가져온 자격 증명입니다. 암호 값은
{technicalAccountId}:{credential}
형식을 사용합니다.
- 만료될 자격 증명 암호는 1,000자 이상의 영숫자 문자열입니다. 예시는 제공되지 않을 것입니다.
- 만료되지 않는 자격 증명 암호는 다음과 같습니다.
4F2611B8613DK3670V495N55:3d182fa9e0b54f33a7881305c06203ee
다음 단계
만료될 때까지 및 만료되지 않는 자격 증명이 모두 작동하는 방식을 이해했으므로 이러한 자격 증명을 사용하여 외부 클라이언트에 연결할 수 있습니다. 외부 클라이언트에 대한 자세한 내용은 클라이언트를 쿼리 서비스에 연결을 참조하십시오.