Show Menu
화제×

Query Editor 사용 안내서

Query Editor 는 사용자 인터페이스 내에서 고객 경험 데이터에 대한 쿼리를 작성, 검증 및 실행할 수 Query Service있는 Adobe Experience Platform에서 제공하는 대화형 Experience Platform 도구입니다. Query Editor 은 분석 및 데이터 탐색을 위한 쿼리 개발을 지원하며, 개발용으로 대화형 쿼리를 실행하고 데이터 세트를 채울 수 있는 비대화형 쿼리를 사용할 수 있습니다 Experience Platform.
의 개념과 기능에 대한 자세한 내용 Query Service은 쿼리 서비스 개요를 참조하십시오 . 쿼리 서비스 사용자 인터페이스를 탐색하는 방법에 대한 자세한 내용 Platform은 쿼리 서비스 UI 개요를 참조하십시오 .

시작하기

Query Editor 에 연결하여 쿼리를 유연하게 실행할 수 Query Service있으며 이 연결이 활성화된 동안에만 쿼리가 실행됩니다.

연결 대상 Query Service

Query Editor 초기화하고 열었을 때 연결하는 데 몇 초 Query Service 이 소요됩니다. 콘솔은 아래와 같이 언제 연결되는지 알려줍니다. 편집기가 연결되기 전에 쿼리를 실행하려고 하면 연결이 완료될 때까지 실행이 지연됩니다.

쿼리를 실행하는 방법 Query Editor

실행 후 실행되는 쿼리는 대화식으로 Query Editor 실행됩니다. 즉, 브라우저를 닫거나 다른 곳으로 이동하면 쿼리가 취소됩니다. 또한 쿼리 출력에서 데이터 세트를 생성하기 위해 수행된 쿼리에 대해서도 마찬가지입니다.

다음을 사용하여 쿼리 작성 Query Editor

를 Query Editor사용하면 고객 경험 데이터에 대한 쿼리를 작성하고 실행 및 저장할 수 있습니다. 조직에서 실행되거나 저장된 모든 쿼리 Query Editor는 액세스 권한이 있는 모든 사용자가 사용할 수 Query Service있습니다.

Query Editor에 액세스

UI Experience Platform 에서 왼쪽 탐색 메뉴의 쿼리 를 클릭하여 작업 Query Service 공간을 엽니다. 그런 다음 화면 오른쪽 상단에 있는 질의 만들기를 클릭하여 쿼리를 작성하기 시작합니다. 이 링크는 작업 공간의 페이지에서 사용할 수 Query Service 있습니다.

쿼리 작성

쿼리 편집기는 쿼리를 최대한 쉽게 작성하기 위해 구성됩니다. 아래 스크린샷은 # 버튼과 # 필드가 강조 표시된 상태에서 편집기가 UI에 어떻게 나타나는지 보여줍니다.
개발 시간을 최소화하려면 반환된 행에 제한이 있는 쿼리를 개발하는 것이 좋습니다. 예, SELECT fields FROM table WHERE conditions LIMIT number_of_rows . 쿼리가 예상 출력을 생성하는지 확인한 후 제한을 제거하고 쿼리를 실행하여 출력 CREATE TABLE tablename AS SELECT 으로 데이터 세트를 생성합니다.

작성 툴 Query Editor

  • 자동 구문 강조 표시: SQL을 손쉽게 읽고 구성할 수 있습니다.
  • SQL 키 단어 자동 완성: 쿼리를 입력한 다음 화살표 키를 사용하여 원하는 용어로 이동한 다음 Enter 키를 누릅니다 .
  • 테이블 및 필드 자동 완성: 원하는 테이블 이름 SELECT 을 입력한 다음 화살표 키를 사용하여 원하는 테이블로 이동한 다음 Enter 키를 누릅니다 . 테이블을 선택하면 자동 완성 기능에서 해당 표의 필드를 인식하게 됩니다.

오류 감지

Query Editor 일반 SQL 유효성 검사 및 특정 실행 유효성 검사를 제공하여 쿼리를 작성할 때 자동으로 유효성을 검사합니다. 아래 이미지에 표시된 대로 쿼리 아래에 빨간색 밑줄이 나타나면 쿼리 내의 오류를 나타냅니다.
오류가 감지되면 SQL 코드 위로 마우스를 가져가면 특정 오류 메시지를 볼 수 있습니다.

쿼리 세부 사항

쿼리를 보는 동안 Query Editor쿼리 세부 정보 ​패널에서는 선택한 쿼리를 관리하는 도구를 제공합니다.
이 패널에서는 UI에서 직접 출력 데이터 세트를 생성하고, 표시된 쿼리를 삭제하거나 이름을 지정한 다음, SQL 쿼리 탭에서 복사 형식으로 SQL 코드를 쉽게 볼 수 있습니다. 또한 이 패널에는 마지막으로 쿼리를 수정한 시간과 쿼리를 수정한 사람 등 유용한 메타데이터도 표시됩니다(해당되는 경우). 데이터 세트를 생성하려면 출력 데이터 세트 를 클릭합니다 . # 대화 상자가 나타납니다. 이름과 설명을 입력한 다음 쿼리 실행을 클릭합니다 . 새 데이터 세트는 의 사용자 인터페이스에 있는 데이터 세트 탭 Query Service 에 Platform표시됩니다.

쿼리 저장

Query Editor 은 쿼리를 저장하고 나중에 작업할 수 있도록 해주는 저장 기능을 제공합니다. 쿼리를 저장하려면 의 오른쪽 위 에서 저장을 클릭합니다 Query Editor. 쿼리를 저장하려면 # 패널을 사용하여 쿼리에 사용할 이름을 제공해야 합니다.

이전 쿼리를 찾는 방법

에서 실행된 모든 쿼리 Query Editor 는 로그 테이블에서 캡처됩니다. #탭의 검색 기능을 사용하여 쿼리 실행을 찾을 수 있습니다. 저장된 쿼리는 #탭에 나열됩니다.
자세한 내용은 쿼리 서비스 UI 개요를 참조하십시오.
실행되지 않은 쿼리는 로그에 저장되지 않습니다. 쿼리를 사용할 수 있게 하려면 Query Service에서 쿼리를 실행하거나 저장해야 합니다 Query Editor.

쿼리 편집기를 사용하여 쿼리 실행

쿼리를 실행하려면 편집기에서 SQL을 입력하거나 # 또는 # * 로드한 다음 # 을 클릭합니다**. 쿼리 실행 상태는 아래의 콘솔 탭에 표시되며 출력 데이터는 결과 탭에 표시됩니다.

콘솔

콘솔은 의 상태 및 작업에 대한 정보를 제공합니다 Query Service. 콘솔에는 연결 상태 Query Service, 실행 중인 쿼리 작업 및 이러한 쿼리에서 발생한 오류 메시지가 표시됩니다.
콘솔에는 쿼리 실행으로 인한 오류만 표시됩니다. 쿼리가 실행되기 전에는 쿼리 유효성 검사 오류가 표시되지 않습니다.

쿼리 결과

쿼리가 완료되면 [ 콘솔 탭 옆의 # ] 탭에 결과가 표시됩니다 . 이 보기는 최대 100개의 행을 표시하는 쿼리의 테이블 형식 출력을 보여줍니다. 이 보기에서는 쿼리가 예상 출력을 생성하는지 확인할 수 있습니다. 쿼리를 사용하여 데이터 세트를 생성하려면 반환된 행의 제한을 제거하고 쿼리를 실행하여 출력 CREATE TABLE tablename AS SELECT 으로 데이터 세트를 생성합니다. 쿼리 결과를 통해 데이터 세트를 생성하는 방법에 대한 자세한 내용은 데이터 집합 생성 자습서를 참조하십시오 Query Editor.

자습서 비디오로 쿼리 Query Service 실행

다음 비디오에서는 Adobe Experience Platform 인터페이스와 PSQL 클라이언트에서 쿼리를 실행하는 방법을 보여 줍니다. 또한 XDM 개체에서 개별 속성을 사용하고, Adobe에서 정의된 함수를 사용하고, CREATE TABLE AS SELECT(CTAS SELECT) 사용이 입증됩니다.

다음 단계

사용 가능한 기능과 애플리케이션 탐색 방법을 알고 있으므로 직접 Query Editor 에서 고유한 쿼리를 작성할 수 있습니다 Platform. 데이터 세트에 대한 SQL 쿼리 실행에 대한 자세한 내용 Data Lake은 쿼리 실행 가이드를 참조하십시오 . Adobe Analytics 및 Adobe Target 데이터 작업에 대한 샘플 SQL 쿼리는 샘플 쿼리 참조를 참조하십시오 .