예약된 쿼리 모니터링

Last update: Tue May 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:
Queries

작성 대상:

User
Developer

Adobe Experience Platform은 UI를 통해 모든 쿼리 작업의 상태에 대한 향상된 가시성을 제공합니다. 다음에서 예약된 쿼리 탭에서는 이제 상태, 일정 세부 정보 및 오류 메시지/코드가 실패할 경우 이를 포함하는 쿼리 실행에 대한 중요한 정보를 찾을 수 있습니다. 다음 작업을 통해 이러한 쿼리에 대한 UI를 통해 해당 상태에 따라 쿼리에 대한 경고를 구독할 수도 있습니다. 예약된 쿼리 탭.

예약된 쿼리

다음 예약된 쿼리 탭에서는 모든 예약된 CTAS 및 ITAS 쿼리에 대한 개요를 제공합니다. 모든 예약된 쿼리와 실패한 쿼리에 대한 오류 코드 및 메시지에 대한 실행 세부 정보를 찾을 수 있습니다.

로 이동하려면 예약된 쿼리 탭, 선택 쿼리 왼쪽 탐색 모음 뒤에 오는 예약된 쿼리

예약된 쿼리 및 쿼리가 강조 표시된 쿼리 작업 영역의 예약된 쿼리 탭입니다.

아래 표에서는 사용 가능한 각 열에 대해 설명합니다.

NOTE

경고 구독 아이콘(

)는 제목 없는 열의 각 행에 포함됩니다. 다음을 참조하십시오. 경고 구독 섹션에 자세히 설명되어 있습니다.

열

설명

이름

이름 필드는 템플릿 이름 또는 SQL 쿼리의 처음 몇 문자입니다. UI를 통해 쿼리 편집기로 만든 모든 쿼리의 이름은 처음 만들 때 로 지정됩니다. API를 통해 쿼리를 만든 경우 해당 이름은 쿼리를 만드는 데 사용되는 초기 SQL 코드 조각이 됩니다. 쿼리와 연결된 모든 실행 목록을 보려면 이름 열. 자세한 내용은 쿼리 실행 일정 세부 정보 섹션.

템플릿

쿼리의 템플릿 이름입니다. 템플릿 이름을 선택하여 쿼리 편집기로 이동합니다. 쿼리 템플릿은 편의를 위해 쿼리 편집기에 표시됩니다. 템플릿 이름이 없는 경우 행은 하이픈으로 표시되며 쿼리를 보기 위해 쿼리 편집기로 리디렉션할 수 없습니다.

SQL

SQL 쿼리의 코드 조각입니다.

실행 빈도

쿼리가 실행되도록 설정된 케이던스입니다. 사용 가능한 값은 다음과 같습니다 Run once 및 Scheduled.

작성자:

쿼리를 만든 사용자의 이름입니다.

생성일

쿼리가 생성된 타임스탬프(UTC 형식)입니다.

마지막 실행 타임스탬프

쿼리가 실행된 가장 최근 타임스탬프입니다. 이 열에서는 쿼리가 현재 예약에 따라 실행되었는지 여부를 강조 표시합니다.

마지막 실행 상태

가장 최근 쿼리 실행의 상태입니다. 상태 값: Success, Failed, In progress, 및 No runs.

일정 상태

예약된 쿼리의 현재 상태입니다. 6개의 잠재적 가치가 있습니다. 등록 중, 활성, 비활성, 삭제됨, 하이픈 및 격리됨.

다음 등록 중 상태는 시스템이 계속해서 쿼리에 대한 새 일정 생성을 처리하고 있음을 나타냅니다. 예약된 쿼리가 등록되는 동안에는 비활성화하거나 삭제할 수 없습니다.
다음 활성 상태는 예약된 쿼리에 이 있음을 나타냅니다. 아직 전달되지 않음 완료 날짜 및 시간입니다.
다음 비활성 상태는 예약된 쿼리에 이 있음을 나타냅니다. 전달됨 완료 날짜 및 시간 또는 사용자가 비활성 상태로 표시했습니다.
다음 삭제됨 상태는 쿼리 일정이 삭제되었음을 나타냅니다.
하이픈은 예약된 쿼리가 반복되지 않는 일회성 쿼리임을 나타냅니다.
다음 격리됨 상태는 쿼리가 10회 연속 실행에 실패했음을 나타내며, 추가적인 실행이 수행되기 전에 사용자의 개입이 필요합니다.

TIP

쿼리 편집기로 이동하면 다음을 선택할 수 있습니다 쿼리 (으)로 돌아가기 템플릿 탭.

예약된 쿼리에 대한 표 설정 사용자 지정 customize-table

에서 열을 조정할 수 있습니다. 예약된 쿼리 탭하여 필요에 맞게 변경합니다. 을(를) 열려면 표 맞춤화 설정 대화 상자를 열고 사용 가능한 열을 편집하려면 설정 아이콘( )을 클릭하여 제품에서 사용할 수 있습니다.

NOTE

다음 생성됨 일정이 생성된 날짜를 참조하는 열은 기본적으로 숨겨집니다.

테이블 설정 사용자 지정 아이콘이 강조 표시된 예약된 쿼리 탭입니다.

관련 확인란을 전환하여 테이블 열을 제거하거나 추가합니다. 그런 다음 을 선택합니다. 적용 을 클릭하여 선택 항목을 확인합니다.

NOTE

UI를 통해 생성된 모든 쿼리는 작성 프로세스의 일부로 이름이 지정된 템플릿이 됩니다. 템플릿 이름은 템플릿 열에 표시됩니다. API를 통해 쿼리를 만든 경우 템플릿 열이 비어 있습니다.

표 설정 사용자 지정 대화 상자

인라인 작업으로 예약된 쿼리 관리 inline-actions

다음 예약된 쿼리 보기 는 한 위치에서 모든 예약된 쿼리를 관리하기 위한 다양한 인라인 작업을 제공합니다. 인라인 작업은 줄임표가 있는 각 행에 표시됩니다. 관리할 예약된 쿼리의 줄임표를 선택하여 팝업 메뉴에서 사용 가능한 옵션을 확인합니다. 사용 가능한 옵션은 다음과 같습니다 일정 비활성화 또는 일정 활성화, 일정 삭제, 구독 경고를 쿼리하고 활성화 또는 격리 비활성화.

인라인 작업 줄임표 및 팝업 메뉴가 강조 표시된 예약된 쿼리 탭입니다.

예약된 쿼리 비활성화 또는 활성화 disable

예약된 쿼리를 비활성화하려면 관리할 예약된 쿼리의 줄임표를 선택한 다음 을 선택합니다 일정 비활성화 을 클릭하여 제품에서 사용할 수 있습니다. 작업을 확인하는 대화 상자가 나타납니다. 선택 사용 안 함 설정을 확인합니다.

예약된 쿼리가 비활성화되면 동일한 프로세스를 통해 일정을 활성화할 수 있습니다. 줄임표를 선택한 다음 을 선택합니다. 일정 활성화 사용 가능한 옵션에서

NOTE

쿼리가 격리된 경우 일정을 활성화하기 전에 템플릿의 SQL을 검토해야 합니다. 이렇게 하면 템플릿 쿼리에 문제가 있는 경우 계산 시간 낭비를 방지할 수 있습니다.

예약된 쿼리 삭제 delete

예약된 쿼리를 삭제하려면 관리할 예약된 쿼리의 생략 부호를 선택한 다음 을 선택합니다 일정 삭제 을 클릭하여 제품에서 사용할 수 있습니다. 작업을 확인하는 대화 상자가 나타납니다. 선택 삭제 설정을 확인합니다.

예약된 쿼리가 삭제되면 아님 이(가) 예약된 쿼리 목록에서 제거되었습니다. 타원에서 제공한 인라인 작업은 제거되고 회색으로 표시된 경고 구독 추가 아이콘으로 바뀝니다. 삭제된 일정에 대한 경고는 구독할 수 없습니다. 행은 예약된 쿼리의 일부로 수행된 실행에 대한 정보를 제공하기 위해 UI에 유지됩니다.

삭제된 예약된 쿼리와 회색으로 표시된 경고 구독 아이콘이 강조 표시된 예약된 쿼리 탭입니다.

해당 쿼리 템플릿에 대한 실행을 예약하려면 해당 행에서 템플릿 이름을 선택하여 쿼리 편집기로 이동한 다음 쿼리에 일정을 추가하는 지침 설명서에 설명된 대로.

경고 구독 alert-subscription

예약된 쿼리 실행에 대한 경고를 구독하려면 다음 중 하나를 선택합니다. ... (줄임표) 또는 경고 구독 아이콘( ) 관리할 예약된 쿼리에 사용됩니다. 인라인 작업 드롭다운 메뉴가 나타납니다. 그런 다음 을 선택합니다. 구독 사용 가능한 옵션에서

줄임표, 경고 구독 아이콘 및 인라인 작업 드롭다운 메뉴가 강조 표시된 예약된 쿼리 작업 영역입니다.

다음 경고 대화 상자가 열립니다. 다음 경고 대화 상자는 UI 알림 및 이메일 경고를 모두 구독합니다. 몇 가지 경고 구독 옵션을 사용할 수 있습니다. start, success, failure, quarantine, 및 delay. 해당 상자를 선택하고 저장 구독하기.

경고 구독 대화 상자.

아래 표에서는 지원되는 쿼리 경고 유형에 대해 설명합니다.

경고 유형

설명

start

이 경고는 예약된 쿼리 실행이 시작되거나 처리를 시작할 때 알려줍니다.

success

이 경고는 예약된 쿼리 실행이 성공적으로 완료되면 사용자에게 알려 주며 이는 쿼리가 오류 없이 실행되었음을 나타냅니다.

failed

이 경고는 예약된 쿼리 실행에 오류가 발생하거나 성공적으로 실행되지 않을 때 트리거됩니다. 문제를 신속하게 식별하고 해결하는 데 도움이 됩니다.

quarantine

이 경고는 예약된 쿼리 실행이 격리된 상태로 전환되면 활성화됩니다. 쿼리가 다음에 등록되는 경우 격리 기능, 10번의 연속 실행에 실패한 모든 예약된 쿼리는 자동으로 격리됨 주. 그런 다음 추가 실행이 수행되기 전에 사용자의 개입이 필요합니다.

delay

이 경고는 다음 항목이 있는 경우 사용자에게 알립니다. 쿼리 실행 결과 지연 지정된 임계값을 초과합니다. 완료하거나 실패하지 않고 해당 기간 동안 쿼리가 실행될 때 경고를 트리거하는 사용자 지정 시간을 설정할 수 있습니다.

NOTE

쿼리 실행이 격리된다는 알림을 받으려면 먼저 예약된 쿼리 실행을 격리 기능.

다음을 참조하십시오. 경고 구독 API 설명서 추가 정보.

쿼리 세부 정보 보기 query-details

정보 아이콘( )을 클릭하여 쿼리에 대한 세부 정보 패널을 확인합니다. 세부 정보 패널에는 예약된 쿼리 테이블에 포함된 사실 외에 쿼리의 모든 관련 정보가 포함됩니다. 추가 정보에는 쿼리 ID, 마지막으로 수정한 날짜, 쿼리의 SQL, 일정 ID 및 현재 설정된 일정이 포함됩니다.

정보 아이콘과 세부 정보 패널이 강조 표시된 예약된 쿼리 탭

격리된 쿼리 quarantined-queries

NOTE

'한 번 실행' 애드혹 쿼리에는 격리 경고를 사용할 수 없습니다. 격리 경고는 예약된 일괄 처리(CTAS 및 ITAS) 쿼리에만 적용할 수 있습니다.

격리 기능에 등록되면 10번의 연속 실행에 실패한 모든 예약된 쿼리가 자동으로 격리됨 상태. 이 상태의 쿼리는 비활성화되고 예약된 케이던스로 실행되지 않습니다. 그런 다음 더 이상의 실행이 수행되기 전에 사용자의 개입이 필요합니다. 이렇게 하면 추가 실행이 발생하기 전에 SQL 문제를 검토하고 수정해야 하므로 시스템 리소스를 보호합니다.

격리 기능에 대해 예약된 쿼리를 활성화하려면 줄임표(...) 다음에 오는 격리 활성화 드롭다운 메뉴가 표시됩니다.

인라인 작업 드롭다운 메뉴에서 줄임표 및 격리 활성화 가 강조 표시된 예약된 쿼리 탭입니다.

일정 생성 프로세스 중에 쿼리를 격리 기능에 등록할 수도 있습니다. 다음을 참조하십시오. 쿼리 일정 설명서 추가 정보.

쿼리 실행 지연 query-run-delay

쿼리 지연에 대한 경고를 설정하여 컴퓨팅 시간을 제어할 수 있습니다. 특정 기간 후에도 쿼리 상태가 변경되지 않은 경우 쿼리 성능을 모니터링하고 알림을 받을 수 있습니다. ' 사용쿼리 실행 지연' 쿼리가 완료되지 않고 특정 기간 후에도 계속 처리되는 경우 알림을 받을 수 있습니다.

다음을 수행하는 경우 경고 구독 예약된 쿼리 실행의 경우 사용할 수 있는 경고 중 하나는 입니다. 쿼리 실행 지연. 이 경고를 사용하려면 실행하는 데 소요된 시간에 대한 임계값을 설정해야 하며, 이 시점에서 처리 지연에 대한 알림을 받게 됩니다.

알림을 트리거하는 임계값 기간을 선택하려면 텍스트 입력 필드에 숫자를 입력하거나 위쪽 및 아래쪽 화살표를 사용하여 1분 단위로 증가시킵니다. 임계값이 분 단위로 설정되므로 쿼리 실행 지연을 관찰하는 최대 기간은 1440분(24시간)입니다. 실행 지연의 기본 시간은 150분입니다.

NOTE

쿼리 실행에는 하나의 실행 지연 시간만 있을 수 있습니다. 지연 임계값을 변경하면 경고를 구독한 사용자 및 전체 조직에 대해 변경됩니다.

예약된 쿼리 탭의 경고 대화 상자에서 쿼리 실행 지연 입력 필드가 강조 표시됩니다.

다음 방법에 대해 알아보려면 경고 구독 섹션을 참조하십시오 구독 대상 쿼리 실행 지연 경고.

쿼리 필터링 filter

실행 빈도에 따라 쿼리를 필터링할 수 있습니다. 다음에서 예약된 쿼리 탭에서 필터 아이콘( )을 클릭하여 필터 사이드바를 엽니다.

필터 아이콘이 강조 표시된 예약된 쿼리 탭.

실행 빈도에 따라 쿼리 목록을 필터링하려면 다음 중 하나를 선택합니다. 예약됨 또는 한 번 실행 확인란을 필터링합니다.

NOTE

실행되었지만 예약되지 않은 모든 쿼리는 한 번 실행.

필터 사이드바가 강조 표시된 예약된 쿼리 탭입니다.

필터 기준을 활성화했으면 다음을 선택합니다. 필터 숨기기 필터 패널을 닫습니다.

쿼리 실행 일정 세부 정보 query-runs

일정 세부 정보 페이지를 열려면 다음에서 쿼리 이름을 선택합니다. 예약된 쿼리 탭. 이 보기는 예약된 쿼리의 일부로 실행된 모든 실행의 목록을 제공합니다. 제공되는 정보에는 시작 및 종료 시간, 상태 및 사용된 데이터 세트가 포함됩니다.

일정 세부 정보 페이지

이 정보는 5열 표로 제공됩니다. 각 행은 쿼리 실행을 나타냅니다.

열 이름

설명

쿼리 실행 ID

일별 실행에 대한 쿼리 실행 ID입니다. 다음 항목 선택 쿼리 실행 ID 을 클릭하여 다음 위치로 이동합니다. 쿼리 실행 개요.

쿼리 실행 시작

쿼리가 실행된 타임스탬프. 타임스탬프는 UTC 형식입니다.

쿼리 실행 완료

쿼리가 완료된 타임스탬프. 타임스탬프는 UTC 형식입니다.

상태

가장 최근 쿼리 실행의 상태입니다. 상태 값: Success, Failed, In progress, 또는 Quarantined.

데이터 세트

실행과 관련된 데이터 세트입니다.

예약되는 쿼리에 대한 세부 정보는 다음에서 볼 수 있습니다. 속성 패널. 이 패널에는 초기 쿼리 ID, 클라이언트 유형, 템플릿 이름, 쿼리 SQL 및 일정의 케이던스가 포함됩니다.

속성 패널이 강조 표시된 예약 세부 정보 페이지입니다.

쿼리 실행 ID를 선택하여 실행 세부 정보 페이지로 이동하고 쿼리 정보를 확인합니다.

실행 ID가 강조 표시된 예약 세부 정보 화면입니다.

쿼리 실행 개요 query-run-overview

다음 쿼리 실행 개요 은(는) 이 예약된 쿼리의 개별 실행에 대한 정보와 실행 상태에 대한 보다 자세한 분류를 제공합니다. 이 페이지에는 또한 클라이언트 정보와 쿼리 실패의 원인이 될 수 있는 모든 오류에 대한 세부 정보가 포함되어 있습니다.

개요 섹션이 강조 표시된 실행 세부 정보 화면입니다.

쿼리 상태 섹션은 쿼리가 실패한 경우 오류 코드와 오류 메시지를 제공합니다.

오류 섹션이 강조 표시된 실행 세부 정보 화면입니다.

이 보기에서 쿼리 SQL을 클립보드에 복사할 수 있습니다. 쿼리를 복사하려면 SQL 코드 조각의 오른쪽 상단에서 복사 아이콘을 선택합니다. 코드가 복사되었음을 확인하는 팝업 메시지가 표시됩니다.

SQL 복사 아이콘이 강조 표시된 실행 세부 정보 화면입니다.

익명 블록이 있는 쿼리에 대한 세부 정보 실행 anonymous-block-queries

익명 블록을 사용하여 SQL 문을 구성하는 쿼리는 개별 하위 쿼리로 구분됩니다. 하위 쿼리로 구분하면 각 쿼리 블록에 대한 실행 세부 사항을 개별적으로 검사할 수 있습니다.

NOTE

DROP 명령을 사용하는 익명 블록의 실행 세부 정보는 아님 별도의 하위 쿼리로 보고됩니다. 익명 블록 하위 쿼리로 사용되는 CTAS 쿼리, ITAS 쿼리 및 COPY 문에 대해 별도의 실행 세부 정보를 사용할 수 있습니다. DROP 명령에 대한 실행 세부 정보는 현재 지원되지 않습니다.

익명 블록은 $$ 접두사를 쿼리 앞에 추가합니다. 쿼리 서비스의 익명 블록에 대한 자세한 내용은 익명 블록 문서.

익명 블록 하위 쿼리는 실행 상태 왼쪽에 탭이 있습니다. 실행 세부 정보를 표시하려면 탭을 선택합니다.

익명 블록 쿼리를 표시하는 쿼리 실행 개요입니다. 여러 쿼리 탭이 강조 표시됩니다.