SQLly 지시문
정상 동작결과의 모습 — 열, 너비, 형식, 색상, 피벗, 차트를 기억하는 작은 SQL 주석입니다.
A 지시문 SQLly가 이해하는 일반적인 SQL 주석입니다. 데이터베이스에는 단순한 주석으로 보이지만, SQLly는 이를 사용하여 결과를 형성하거나 형식을 지정합니다. 지시문은 쿼리 텍스트 안에 있기 때문에, 파일과 함께 이동하며 실행할 때마다 다시 적용됩니다.
모든 지시문은 하나의 네임스페이스를 공유합니다 - 주석 마커 뒤에 오는 sqlly 주석 표시 이후:
-- sqlly view: pivot
-- sqlly grid: order=Region, Year, Sales; freeze=1; sort=Sales desc
-- sqlly pivot: row:Region; column:Year; value:Sales:sum
-- sqlly chart: kind:bar; label:Region; values:Sales
-- sqlly format: column=Sales; number=2; width=40dp
-- sqlly conditional: column=Sales; bar=#5B9BD5
-- sqlly column: Running Total = !Sales + N(!"Running Total"[1])
-- sqlly map: lat=Latitude; lon=Longitude; color=Region; cluster=on
직접 입력할 일은 거의 없습니다. 원하는 대로 결과를 배치한 다음 결과 이름 앞의 lock 결과 이름 앞에 있습니다. SQLly는 배열 전체를 하나의 지시문 블록으로 쿼리에 기록합니다. 다음을 보세요 그리드 잠금.
지시문 계열
| 지시문 | 기능 | 예시 |
|---|---|---|
view: | 결과를 다음 형식으로 엽니다 grid (기본값), pivot, 또는 chart; map 는 그리드를 유지하고 결과를 지도에서 열기도 합니다. | -- sqlly view: chart |
grid: | 그리드의 열 배열: 순서, 숨김 및 고정 열, 정렬, 그룹화, 열 필터, 외래 키 레이블. grid 2: 하나의 결과 집합을 만들고 번호는 1부터 매겨집니다. | -- sqlly grid: hide=Notes; freeze=1; sort=Total desc |
format: | 하나의 결과 열이 어떻게 표시되는지, 그리고 열의 너비가 얼마나 되는지. | -- sqlly format: column=Created; date=%Y-%m-%d; width=40dp |
conditional: | 이 쿼리의 값을 기준으로 셀 색상을 지정합니다: 강조 규칙, 색상 스케일 또는 데이터 막대. 규칙은 줄마다 하나씩. | -- sqlly conditional: column=Status; when=is Failed; text=#B00020; bold |
column: | 결과의 기존 열을 이용해 Excel 수식으로 계산된 열을 추가합니다: !Name 이 행입니다, !Name[1] 는 바로 앞 행입니다. Excel의 함수와 연산자를 그대로 쓸 수 있습니다. | -- sqlly column: Total = !Qty * !Price |
pivot: | 피벗 테이블의 행, 열 및 집계된 값. result:N 이 어느 결과 집합에 속하는지 지정합니다. | -- sqlly pivot: row:Rep; column:Quarter; value:Deals:count |
chart: | 차트 유형, 범주 레이블, 시리즈 및 집계. result:N 이 어느 결과 집합에 속하는지 지정합니다. | -- sqlly chart: kind:line; label:Month; values:Revenue,Cost |
map: | 결과가 지도에 표시되는 방식: 위치 열, 레이블과 툴팁, 색상과 크기, 점 또는 히트맵 (가중치, 반경, 블러, 강도, 불투명도, 팔레트), 클러스터링, 거리 지도, 시작 뷰, 클릭 동작, 그리고 지도가 자동으로 열리는지 여부. map 2: 하나의 결과 집합을 만들고 번호는 1부터 매겨집니다. | -- sqlly map: mode=heatmap; weight=orders; radius=30 |
/* sqlly lock | 결과의 자물쇠를 클릭할 때 SQLly가 남기는 블록 주석입니다. 이 주석의 -- sqlly 줄은 결과를 본모습 그대로 정확히 재현합니다. | /* sqlly lock — … … */ |
name | 결과 집합 탭에 1부터 라벨을 붙입니다. 배치가 여러 결과를 반환할 때 유용합니다. | -- sqlly name 2: Open Orders |
2x2 / result: | 여러 결과 집합을 한 캔버스에 배열하며, 각 SQL 문 결과를 셀에 배치합니다. | -- sqlly result: 1|2 |
layout: | 실행 결과를 다음 방식으로 배치합니다 stacked, tabbed, 또는 canvas, 파일을 여는 곳 어디에서든요. | -- sqlly layout: stacked |
lines: | 스택으로 쌓인 각 카드에 할당되는 행; lines 2: 하나의 결과 집합을 만들고 번호는 1부터 매겨집니다. | -- sqlly lines 2: 20 |
focus: | 결과가 도착했을 때 어떤 결과 집합이 보이는지: Tabbed 모드에서는 그 탭이 선택되고 Stacked 모드에서는 그 카드가 스크롤되어 나타납니다. 1부터 셉니다. | -- sqlly focus: 2 |
param: | 매개변수를 선언하거나, 다음 :name 자리 표시자에 유형과 기본값을 지정합니다. 결과 위의 입력 줄에서 실행할 때마다 값을 입력할 수 있고, 일반 :id, ? 그리고 $1 자리 표시자는 선언 없이도 입력 칸이 생깁니다(자세한 내용은 쿼리 매개변수). | -- sqlly param: @CustomerId int |
set | 모든 항목을 바꾸는 텍스트 변수를 정의합니다 ${name} 쿼리가 실행되기 전에. | -- sqlly set schema = dbo |
param: 그리고 set 이 두 가지가 데이터베이스가 실제로 받는 내용을 바꿉니다. SQLly는 SQL을 보내기 전에 문자열과 주석 바깥에서 그 값을 SQL에 치환해 넣습니다. 파라미터 값은 선언된 타입의 이스케이프된 리터럴로 들어갑니다 (text, int, decimal, bool, date, 또는 datetime). 다음은 set 값은 있는 그대로 들어갑니다. 계산 열(computed-column) 수식은 두 가지를 모두 읽습니다 @name.
지시문(directive)이 들어가야 하는 위치
- 별도의 줄에 배치됩니다. 같은 줄의 SQL 코드 뒤에 있는 지시문은 무시됩니다.
name은(는) 유일한 예외이며 줄 끝 주석으로 동작합니다. view:그리고 캔버스 크기는 첫 줄에 적습니다. 지시문은 쿼리에서 비어 있지 않은 첫 줄에서만 읽힙니다. 맨 위 lock 블록 안에서는 블록의 첫 지시문 줄이 그 첫 줄로 칩니다.- 공백은 관대한 편입니다 대부분의 계열에서는:
--sqlly view: pivot그리고-- SQLLY view: pivot둘 다 작동합니다. format:엄격합니다. 철자는 정확히 다음과 같아야 합니다-- sqlly format:, 다음 뒤에는 공백을 둡니다--.- 블록 주석 안에서는 지시문이 해제됩니다 - 이는 잠시 동안 하나를 비활성화하는 편리한 방법입니다. 한 가지 예외는
/* sqlly lock블록: 각 줄이 별도의 한 줄로 적힌 것과 정확히 같게 동작합니다.
-- sqlly view: pivot -- sqlly pivot: row:Region; column:Year; value:Sales:sum -- sqlly format: column=Sales; number=2 SELECT Region, Year, Sales FROM sales;
sqlly 네임스페이스에 있지만 철자가 틀렸거나, 적용될 수 없는 위치에 있거나, 알 수 없는 값이 지정된 경우 SQLly는 조용히 무시하는 대신 편집기에 밑줄을 그어 이유를 알려 줍니다. 예를 들어, -- sqlly view: table 다음을 받습니다 알 수 없는 뷰 — 예상되는 값은 -- sqlly view: grid, -- sqlly view: pivot, -- sqlly view: chart, 또는 -- sqlly view: map.Autocomplete as you type
You don't have to remember any of the spellings above. As soon as a comment looks like a directive, the editor's suggestion list follows the cursor through it and offers the next thing the directive can take:
| You have typed | The list offers |
|---|---|
-- on a line of its own | A ready-made starter line for each kind of directive. view: and the canvas size are offered only on the query's first line, where they work. |
-- sq | 그 sqlly namespace. |
-- sqlly | Every directive family: view:, grid:, format:, pivot:, chart: and the rest. |
-- sqlly grid: | The settings that family takes, leaving out the ones already on the line. |
-- sqlly grid: sort= | The values that setting accepts: here the result's columns. Elsewhere chart kinds, pivot aggregates, filter operators, map modes, number and date formats, time zones, colors. |
-- sqlly grid: sort=Total | What may follow the value: here asc 또는 desc. |
- One choice opens the next. Accepting a setting opens its values straight away, so a whole directive can be built by picking from lists with Tab or Enter.
- Your real column names. Wherever a directive expects a column, the list shows the columns the tab's last run returned, quoted the way that directive needs them. Run the query once to get them.
- Formulas and parameters too. In a
column:formula the list completes column references, Excel worksheet functions and@variables. On aparam:line it offers the query's placeholders that are not declared yet, then every parameter type. - Only what works. Everything in the list is exactly what the directive accepts, so an accepted suggestion never earns the warning underline described above.
- Bring it back anywhere inside a directive with Ctrl+공백, on macOS too.
앱에서 도움말
- 호버 any
-- sqlly주석에 마우스를 올리면 짧은 설명이 나오고, 전체 옵션 목록 링크도 함께 표시됩니다. - 도움말 › 서식 지시문… (명령 팔레트에도 있음)은 모든 계열과 그 매개변수, 바로 복사할 수 있는 예제를 담은 참조 창을 엽니다.
- SQLly가 작성하도록 하세요. 결과 이름 앞의 자물쇠를 클릭하여 전체 결과를 지시문으로 작성하거나, 결과 열 헤더를 마우스 오른쪽 버튼으로 클릭하고 서식 › 서식 재정의 설정… 를 선택하여 하나의
format:지시문을 대신 써 줍니다.
이 섹션에서
- 그리드
- 열 순서, 숨긴 열과 고정한 열, 정렬, 그룹화, 필터가 쿼리에 기록됩니다.
- 서식 개발 중
- 쿼리가 실행될 때마다 각 열에 어울리는 표시 형식과 너비가 자동으로 잡힙니다.
- 조건부
- 값에 따라 한 쿼리의 셀 색상을 지정합니다: 강조 규칙, 색상 스케일, 데이터 막대.
- 계산된 열
- Excel 수식으로 작성하는 열을 추가했습니다: 누계, 마진, 이전 행 대비 변화, 날짜.
- 피벗
- 짧고 이식성 있는 주석 하나로 익숙한 결과 집합을 교차 집계표로 바꿔 보세요.
- 차트
- 결과가 도착하기도 전에 차트 탭에 어떤 이야기를 그릴지 알려 주세요.
- 그리드 잠금
- 클릭 한 번으로 지금 화면에 보이는 그대로의 결과를 쿼리에 기록하므로, 실행할 때마다 늘 같은 결과가 돌아옵니다.