조회 함수: 명령 및 구문
조회 함수를 사용하여 사용자 관리 테이블에서 정보를 반환합니다.
CPQ 는 SQL 기반 쿼리 언어를 사용하여 사용자 관리 테이블을 조회합니다.
조회 함수는 테이블에서 최대 10,000개의 행을 반환하고 검색이 계속 쿼리되는 경우 30초 후에 시간 초과됩니다. 관리 테이블에 CSV 파일을 업로드하는 방법에 대한 자세한 내용은 다음 문서를 참조하십시오 매트릭스 로더: CSV 테이블 업로드.
조회 함수 사용에 대한 일반적인 지침에 대한 자세한 내용은 다음 문서를 참조하십시오 테이블 쿼리 최소화.
지원되는 명령
- SELECT는 테이블에서 열(","로 구분)을 선택합니다.
- FROM는 쿼리가 데이터를 가져올 테이블을 선택합니다.
- WHERE는 다른 열을 검색할 조건을 설정합니다.
- AND는 두 개의 WHERE 조건을 결합합니다(둘 다 예여야 함).
- OR은 두 개의 WHERE 조건을 결합합니다(둘 중 하나가 예일 수 있음).
구문
예제 쿼리:
var tableResults = lookup("SELECT column1, column2 FROM tableName WHERE column3 = :key1 OR (column4 != :key2 AND column5 IN :list)", {"key1": "value", "key2":cfg.[singleFieldName], "list":cfg.[multiFieldName]});
첫 번째 매개변수는 관리 테이블을 쿼리하는 데 사용되는 SQL 기반 명령 문자열입니다.
두 번째 매개변수는 쿼리에 삽입할 키-값 맵입니다. 값은 상수, 변수 또는 필드일 수 있습니다.
tableResults 변수에는 결과 배열이 있습니다. 이 변수 자체를 반환할 수 없습니다. 결과는 인덱스(tableResults[0], tableResults[1]...)에서 참조되어야 하며 원하는 수의 결과 또는 아무 것도 포함하지 않을 수 있습니다.
"... 인덱스 '0'이 범위를 벗어났습니다..." 테이블 조회로 작업할 때 빈 배열을 참조하려고 할 수 있습니다. 테이블 결과에 대해 null 검사를 실행하는 것이 좋습니다.
비교기:
- =
- 이(가) 다음과 같음
- !=
- 같지 않음
- >
- 보다 큼
- <
- 보다 작음
- >=
- 크거나 같음
- 안에
- 임의(집합 내)와 같음
IN 형식은 다음 형식의 모든 컬렉션에서 작동합니다.
lookup("SELECT column1 FROM table WHERE column2 IN (:options)",{options = cfg. [multi picklistField]});