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
これらを入力する必要はほとんどありません。結果をお好みの形に並べ替えたら、結果の名前の前にある ロック 結果名の前に付けると、SQLly は配置全体をディレクティブの 1 つのブロックとしてクエリに書き込みます。参照 グリッドをロックする.
ディレクティブの種類
| ディレクティブ | 何ができるか | 例 |
|---|---|---|
view: | 結果を次の形式で開きます grid (デフォルト)、 pivot、または chart; map グリッドを維持したまま、結果を地図でも開きます。 | -- sqlly view: chart |
grid: | グリッドの列の構成: 順序、非表示と固定の列、並べ替え、グループ化、列フィルター、そして外部キーのラベル。 grid 2: は、1 から数えた番号で 1 つの結果セットを対象にします。 | -- sqlly grid: hide=Notes; freeze=1; sort=Total desc |
format: | 1 つの結果列をどのように表示するか、その幅をどうするか。 | -- sqlly format: column=Created; date=%Y-%m-%d; width=40dp |
conditional: | このクエリについて、セルの値に応じてセルに色を付けます。ハイライトルール、カラースケール、データバーのいずれかを使います。1 行に 1 つのルールです。 | -- 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 から数えた番号で 1 つの結果セットを対象にします。 | -- sqlly map: mode=heatmap; weight=orders; radius=30 |
/* sqlly lock | 結果のロックをクリックしたときに SQLly が書き込むブロックコメント。その -- sqlly 行は、結果を見たとおりに正確に再現します。 | /* sqlly lock — … … */ |
name | 結果セットのタブにラベルを付けます(1 から数えます)。バッチが複数の結果を返すときに便利です。 | -- sqlly name 2: Open Orders |
2x2 / result: | 複数の結果セットを 1 つのキャンバスに配置し、各ステートメントの結果をセルに置きます。 | -- sqlly result: 1|2 |
layout: | 実行結果を次の形式で開きます stacked, tabbed、または canvas、ファイルをどこで開いても。 | -- sqlly layout: stacked |
lines: | 各スタックカードに割り当てられる行数; lines 2: は、1 から数えた番号で 1 つの結果セットを対象にします。 | -- sqlly lines 2: 20 |
focus: | 結果が届いたときに表示される結果セットです。タブ表示ではそのタブが選択され、積み重ね表示ではそのカードが表示位置までスクロールされます。1 から数えます。 | -- sqlly focus: 2 |
param: | パラメータを宣言するか、 :name プレースホルダーに型と既定値を持たせます。結果の上にあるバーで、実行のたびにその値を入力できます。プレーン :id, ? そして $1 プレースホルダーは宣言がなくても 1 つ割り当てられます(参照: クエリパラメーター). | -- sqlly param: @CustomerId int |
set | テキスト変数を定義し、すべての出現箇所を置き換えます ${name} クエリが実行される前に。 | -- sqlly set schema = dbo |
param: そして set はデータベースが受け取る内容を変更する2つです。SQLlyは、送信前に、文字列とコメントの外側にあるそれらの値をSQLに置き換えます。パラメーターの値は、宣言された型のエスケープ済みリテラルとして入ります(text, int, decimal, bool, date、または datetime)。 set 値はそのまま入力されます。 計算列 数式は両方を次として読み取ります @name.
ディレクティブを置く場所
- 独立した行に置く。 同じ行で SQL コードの後ろにあるディレクティブは無視されます。
nameは唯一の例外で、末尾のコメントとして機能します。 view:とキャンバスサイズは1行目に入ります。 これらは、クエリの最初の空でない行でのみ読み取られます。先頭のロックブロックでは、ブロックの最初のディレクティブ行がその最初の行として数えられます。- 空白の入れ方は柔軟です ほとんどのエンジンファミリーでは:
--sqlly view: pivotそして-- SQLLY view: pivotどちらも動作します。 format:は厳格です。 正確に綴る必要があります-- sqlly format:、次の後にスペースを入れて--.- ブロックコメント内では、ディレクティブは無効になります - これは、1 つをしばらく無効にするのに便利な方法です。唯一の例外は次です
/* sqlly lockブロック: それぞれの行は、1 行ずつ別々に書いた場合とまったく同じように動作します。
-- 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.
アプリ内のヘルプ
- ホバー 任意の
-- sqllyコメントには短い説明が出て、すべてのオプションの一覧へのリンクが付きます。 - ヘルプ › 書式ディレクティブ… (コマンドパレットからも開けます)。すべてのファミリー、そのパラメーター、コピーしてすぐ使える例を載せたリファレンスウィンドウが開きます。
- SQLly に書かせる。 結果名の前にあるロックをクリックすると、結果全体がディレクティブとして書き出されます。または、結果の列ヘッダーを右クリックして次を選択します フォーマット › フォーマットの上書きを設定… 1 つ持つには
format:自動で書かれたディレクティブ。
このセクションでは
- グリッド
- 列の順序、非表示列と固定列、ソート、グループ化、フィルターをクエリに書き込みます。
- フォーマット 進行中
- クエリの実行のたびに、各列にふさわしい表示形式と幅を自動で設定します。
- 条件付き
- 1 つのクエリについて、セルの値に応じてセルを色付けします。ハイライトルール、カラースケール、データバー。
- 計算列
- Excel の数式で書いた列を追加できます。累計、マージン、直前の行からの変化、日付など。
- ピボット
- 見慣れた結果セットを、短くて移植しやすいコメントでクロス集計に変換します。
- チャート
- 結果が返ってくる前に、チャートタブに何を描かせるか指示しておけます。
- グリッドをロックする
- ワンクリックで、現在表示されているとおりの結果がクエリに書き込まれるため、実行のたびに同じ結果が返ります。