매개변수화된 쿼리 parameterized-queries
쿼리 서비스는 쿼리 편집기에서 매개 변수가 있는 쿼리 사용을 지원합니다. 이제 매개 변수가 있는 쿼리를 사용하여 매개 변수에 자리 표시자를 사용하고 실행 시 매개 변수 값을 추가할 수 있습니다. 자리 표시자를 사용하면 명령문이 실행될 때까지 값이 무엇인지 모르는 동적 데이터로 작업할 수 있습니다. 쿼리를 미리 준비하여 비슷한 용도로 다시 사용할 수도 있습니다. 각 사용 사례에 대해 별도의 SQL 쿼리를 만들지 않으므로 쿼리를 재사용하면 상당한 노력을 절약할 수 있습니다.
전제 조건
이 안내서를 계속하기 전에 쿼리 편집기 UI 안내서를 읽어 보십시오. 쿼리 편집기 안내서에서는 Experience Platform 사용자 인터페이스 내에서 고객 경험 데이터에 대한 쿼리를 작성, 유효성 검사 및 실행하는 방법에 대한 자세한 정보를 제공합니다.
매개 변수가 있는 쿼리 구문 syntax
매개 변수가 있는 쿼리는 '$YOUR_PARAMETER_NAME' 형식을 사용하며 점 표기법을 사용하여 연결할 수 있습니다. 매개 변수가 있는 쿼리를 사용하는 예제 SQL 문은 아래에 나와 있습니다.
INSERT INTO
$Database_Name.Schema_Name.adwh_lkup_process_delta_log
(process_name, merge_policy_id, process_status, process_date, create_ts, change_ts)
SELECT
'$Table_Process_Name' process_name,
hash('$Merge_PolicyID') merge_policy_id,
'$process_status' process_status,
to_date('$date_key') process_date,
CURRENT_TIMESTAMP create_ts,
CURRENT_TIMESTAMP change_ts;
매개 변수가 있는 쿼리 만들기 create
UI에서 매개 변수가 있는 쿼리를 만들려면 쿼리 편집기로 이동합니다. 자세한 지침은 쿼리 편집기 액세스에 대한 섹션을 참조하십시오.
'$' 서문을 사용하여 텍스트 편집기의 쿼리에 쿼리 매개변수를 입력합니다. 그런 다음 콘솔 옆에 있는 쿼리 매개 변수 탭을 선택하고 키에 대해 누락된 값을 추가합니다. 필요한 키에 값을 추가하지 않으면 쿼리를 실행할 수 없습니다. 경고 아이콘(
쿼리 로그 세부 정보를 사용하여 매개 변수 값 확인 check-parameter-values
사용된 값이 지속적이지 않으므로 템플릿 내에 매개 변수를 저장할 수 없습니다. 그러나 쿼리 로그 세부 정보 페이지에서 쿼리 실행에 사용되는 매개 변수 값을 찾을 수 있습니다. 이 경우, 로그는 쿼리가 매개 변수가 있는 쿼리임을 나타내지 않습니다. 사용된 값을 찾는 방법에 대한 지침은 쿼리 로그 설명서를 참조하세요.
매개 변수가 있는 쿼리 예약 schedule
매개 변수가 있는 쿼리를 예약하면 매개 변수 값이 저장됩니다. 매개 변수가 있는 쿼리를 예약하려면 쿼리 일정 만들기 안내서에 설명된 대로 일반적인 프로세스에 따라 예약된 쿼리를 만든 다음 쿼리 실행에 사용할 매개 변수 값을 입력하십시오. 이 UI 섹션은 매개 변수가 있는 쿼리에만 나타납니다. 특정 지침은 예약된 매개 변수가 있는 쿼리에 대한 매개 변수 설정의 섹션을 참조하십시오.
다음 단계
이 문서를 읽은 후에는 Adobe Experience Platform UI에서 쿼리를 매개 변수화하고 예약된 쿼리 실행에 사용하는 방법에 대해 알아보았습니다. 이 문서에서는 쿼리 실행에 사용되는 매개 변수 값에 대한 로그를 확인하는 방법도 강조했습니다.
다음으로, Platform UI를 통해 모든 쿼리 작업의 상태를 더 잘 이해하려면 예약된 쿼리 모니터링에 대한 안내서를 읽는 것이 좋습니다.