본문으로 건너뛰기
번역된 페이지

이 페이지는 AI의 도움을 받아 영어에서 번역되었습니다. 두 내용이 다를 경우 영어 버전을 기준으로 합니다.

exec

StackQL 쿼리를 단일 문으로 실행하거나 StackQL 스크립트(IQL 파일)의 문 배치로 실행하는 데 사용하는 명령입니다.


구문​

stackql exec [query] [flags]


인수​

인수설명예제
query수행할 StackQL 쿼리
또는 실행할 명령
"SELECT * FROM google.compute.instances
WHERE project = 'myproject' AND zone = 'us-east1-a'"
쿼리는 작은따옴표 또는 큰따옴표로 묶어야 합니다

플래그​

플래그설명
-o
--output
출력 모드입니다. 유효한 값은 table(기본값), json, jsonl(줄 바꿈으로 구분된 JSON, ndjson도 별칭으로 허용됨), csv, text, otel(OpenTelemetry 로그 레코드, 출력 모드 참조)입니다. 예: --output jsonl
-i
--infile
필요한 경우 지정한 파일에서 쿼리를 실행합니다. 이 플래그를 지정하면 인수로 제공한 쿼리는 무시됩니다. 예: --infile myquery.iql
-q
--iqldata
json 또는 jsonnet 파일을 사용하는 명령의 소스 데이터입니다. 예: --iqldata vars.jsonnet
--dryrun드라이 런 플래그입니다. 전처리기만 실행되고 그 출력이 반환됩니다
--var--iqldata 플래그로 지정한 jsonnet 파일에서 사용하는 외부 변수(환경 변수 또는 시크릿 사용 가능)입니다. 예: --var region=${AWS_REGION}
-f
--outfile
필요한 경우 결과를 출력할 파일입니다(기본 동작은 결과를 콘솔에만 출력하는 것입니다). 예: --outfile myoutput.csv
-h
--help
도움말 정보를 출력합니다
-v
--verbose
추가 출력을 stdout으로 보내는 자세한 정보 표시 모드로 쿼리를 실행합니다. -f 옵션을 선택하면 이 추가 로깅 정보가 쿼리 결과와 함께 출력 파일에 기록됩니다


추가 옵션은 전역 플래그를 참조하세요.


예제​

쿼리 결과를 테이블 형식으로 콘솔에 출력합니다.

stackql exec "SHOW services IN google"

쿼리 결과를 json 형식으로 콘솔에 출력합니다.

stackql exec "SHOW services IN google" -o json

쿼리 결과를 json 형식으로 파일에 출력합니다.

stackql exec "SHOW services IN google" -o json -f services.json

입력 파일(IQL 파일)에서 쿼리를 실행하고 결과를 json 형식으로 파일에 출력합니다.

stackql exec -i getservices.iql -o json -f services.json

종료 상태​

exec 명령은 입력 처리가 끝나면 상태 0으로 종료됩니다. 개별 문의 오류는 콘솔에 기록되므로 스크립트에서 출력을 검사해야 합니다. v1.0부터는 SET 또는 UNSET 구성 문이 실패하거나, 액세스 관리가 활성화된 상태에서 문이 거부되거나, 미리 보기 IaC 실행에서 실패한 리소스를 보고하면 상태 1로 종료됩니다.