Show Menu
화제×

쿼리 편집기 사용 안내서

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

시작하기

쿼리 편집기는 쿼리 서비스에 연결하여 쿼리를 유연하게 실행할 수 있도록 하며 이 연결이 활성화된 상태에서만 쿼리가 실행됩니다.

쿼리 서비스에 연결

쿼리 편집기를 열면 쿼리 서비스를 초기화하고 연결하는 데 몇 초가 걸립니다. 콘솔은 아래와 같이 언제 연결되는지 알려줍니다. 편집기가 연결되기 전에 쿼리를 실행하려고 하면 연결이 완료될 때까지 실행이 지연됩니다.

쿼리 편집기에서 쿼리를 실행하는 방법

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

쿼리 편집기를 사용한 쿼리 작성

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

쿼리 편집기 액세스

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

쿼리 작성

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

쿼리 편집기에서 도구 작성

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

오류 감지

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

쿼리 세부 사항

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

쿼리 저장

쿼리 편집기는 쿼리를 저장하고 나중에 작업할 수 있도록 해주는 저장 기능을 제공합니다. 쿼리를 저장하려면 쿼리 편집기의 오른쪽 맨 위에 있는 저장을 클릭합니다. 쿼리를 저장하려면 먼저 쿼리 세부 사항 패널을 사용하여 쿼리에 사용할 이름을 제공해야 합니다 .

이전 쿼리를 찾는 방법

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

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

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

콘솔

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

쿼리 결과

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

다음 단계

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