이 페이지는 AI의 도움을 받아 영어에서 번역되었습니다. 두 내용이 다를 경우 영어 버전을 기준으로 합니다.
StackQL 사용
StackQL에는 여러 사용 모드가 있습니다. StackQL 대화형 셸, StackQL 문을 사용하는 StackQL 명령줄, 입력 파일(IQL 파일)에 있는 하나 이상의 StackQL 문 실행이 여기에 해당합니다. 각 모드는 아래에서 자세히 설명합니다.
- StackQL 대화형 셸 사용(
stackql shell) - StackQL 명령줄 유틸리티 사용(
stackql exec) - 입력 파일(IQL 파일) 사용(
stackql exec -i)
StackQL 대화형 셸 사용
StackQL 셸은 엔지니어가 클라우드 리소스를 배포하고 상호 작용할 수 있는 대화형 프로그래밍 환경을 제공하며, 클라우드 환경을 대화형으로 분석(SELECT 문 사용)할 수 있게 합니다. 셸은 기능적으로 MySQL 셸이나 기타 REPL(Read Evaluate Print Loop) 셸과 비슷합니다. 셸은 유효한 StackQL 문을 받아 사용자에게 결과를 반환합니다. 문은 여러 줄에 걸쳐 작성할 수 있으며, 세미콜론 종결자를 입력하면 실행됩니다.
StackQL 셸은 아래와 같이 shell 명령을 사용하여 호출할 수 있습니다(프로바이더 인증에 대한 정보는 StackQL Provider Registry를 참조하세요).
# Launching the StackQL Interactive Shell
stackql shell --auth="${AUTH}"
클라우드 제공업체에 인증된 셸에 들어가면 StackQL 쿼리(SELECT 쿼리 또는 코드형 인프라에 해당하는 DDL 작업)를 실행할 수 있습니다.
기본적으로 StackQL 셸은 표 형식의 결과를 반환하지만, --output 플래그를 사용하여 json, jsonl, csv, text 출력 형식을 사용할 수도 있습니다. 출력 모드를 참조하세요.
아래와 같이 --colorscheme 플래그를 사용하여 StackQL 셸의 색 구성표를 변경할 수 있습니다.
# Changing the Shell Color Scheme
./stackql shell --colorscheme light
.stackqlrc 초기화 파일
앞에서 설명한 출력 형식, 색 구성표 같은 StackQL 명령 옵션의 기본값은 stackqlrc 초기화 파일을 사용하여 설정할 수 있습니다. 이 파일이 StackQL 실행 파일이 사용하는 현재 디렉터리에 있으면 자동으로 로드됩니다. 또는 아래와 같이 --configfile 플래그를 사용하여 이 파일을 참조할 수도 있습니다.
# Specifying an Initialization (.stackqlrc) File
./stackql shell --configfile /tmp/.stackqlrc
명령 옵션에 대한 자세한 내용은 전역 플래그 항목에서 확인할 수 있습니다.
StackQL 명령줄 유틸리티 사용
StackQL 명령은 StackQL 실행 파일의 exec 명령을 사용하여 비대화형으로 실행할 수 있습니다. 각 개별 명령이 세미콜론(;)으로 끝나면 여러 명령을 하나의 배치로 실행할 수 있습니다. --output 플래그 같은 명령 플래그는 명령줄에서 지정하거나 앞에서 설명한 .stackqlrc 초기화 파일을 사용하여 지정할 수 있습니다.
StackQL 실행 파일의 출력은 사용 중인 시스템의 stdout으로 전송되며, 이 출력은 BASH 또는 PowerShell 스크립트에서 구문 분석할 수 있습니다.
다음은 StackQL 명령을 포함하는 Windows PowerShell 스크립트의 예입니다.
$gcp_project = "stackql-demo"
$gcp_zone = "australia-southeast1-a"
$env:GOOGLE_CREDENTIALS = Get-Content -Raw "C:\tmp\stackql-demo.json"
Write-Output "Selecting instances in ${gcp_zone}..."
$query = "`"select id, name, machineType `
from google.compute.instances `
where project = '${gcp_project}' `
and zone = '${gcp_zone}';`""
$flags = "--output json"
$cmd = "stackql.exe exec"
$select = $cmd, $query, $flags -join " "
(iex $select | ConvertFrom-Json) | Out-GridView -Title 'StackQL Query Results'
위 PowerShell 명령은 Compute Engine 인스턴스를 선택하고 Out-GridView cmdlet을 사용하여 출력을 표시하는 방법을 보여 줍니다.
입력 파일(IQL 파일) 사용
StackQL 입력 파일을 사용하면 세미콜론으로 끝나는 여러 명령을 실행할 수 있습니다. 이는 비대화형 또는 배치 인프라 프로그래밍을 위한 또 다른 옵션입니다. 입력 파일은 아래와 같이 -i 또는 --infile 옵션으로 지정합니다.
# create an iql file
echo "select id, name from google.compute.instances \
where project = 'stackql-demo' \
and zone = 'australia-southeast1-a'" > listinstances.iql
# execute an iql file
./stackql exec -i listinstances.iql \
--auth '{ "google": { "type": "service_account", "credentialsfilepath": "/mnt/c/tmp/stackql-demo.json" } }' \
--output json | jq '.[] | .name'