条件付き書式
実装済みハイライトルール、カラースケール、データバーを使って、セルの値に応じてセルに色を付けます。設定は列名に対して保存することも、1 つのクエリに書き込むこともできます。
条件付き書式は、セルの内容に応じて色を付けるので、重要な値が長い結果の中でも目に飛び込んできます。失敗したジョブは赤、負の残高はピンクの背景、遅いクエリは緑から赤へのグラデーション、売上は棒グラフで表示できます。データそのものは一切変更されず、コピーとエクスポートには引き続きデータベースの元の値が使われます。
設定方法は 2 つあり、組み合わせて使えます:
- 条件付き書式ダイアログ 次のためのルールを保存します 列名。その名前の列を持つすべての結果グリッドに、すべてのクエリで適用されます。
- その
conditional:ディレクティブ ルールを次に書き込みます 1 つのクエリ。それらはファイルと一緒に持ち運ばれ、そのファイルの中でのみ有効です。
条件付き書式ダイアログ
結果の列ヘッダーを右クリックし、次を選択します フォーマット › 条件付き書式…。ダイアログのタイトルには列の名前が付き、その列のルールを編集します。


- ルール一覧 上部には、チェックされる順に列のルールが表示され、それぞれ次のような短い文で示されます 値 > 10000 → 背景 + 太字, 列の範囲全体に対するカラースケール、または 値に比例するデータバー. 削除 ルールを削除します。ルールのない列には次のように表示されます この列にはまだルールがありません。
- ルール 追加するルールの種類を選びます(すべて下に一覧されています)。値と比較するルールには次が表示されます 番号 または テキスト ボックス。 の間 2 つ表示します。
- テキスト - 背景、そして 太字 値ルールのスタイルを設定します。少なくとも 1 つ選んでください。
- 低 そして 高 カラースケールの 2 色(初期値は緑→赤)を設定し、 バーの色 データバーの色を設定します。
- ルールを追加 ルールをリストの末尾に追加します。足りないものがある場合は、ダイアログがボタンの横に何が足りないかを表示します: 一致するテキストを入力してください, ルールの文字色、背景、または太字を設定します。、または値が数値ではないこと。
変更は行うとすぐに適用されます。ダイアログの背後のグリッドはすぐに再描画され、他の結果グリッドは次回の更新時にルールを取り込みます。ダイアログはグリッドをブロックしないため、開いている間もスクロールを続けられます。 Esc またはその外側をクリックすると閉じ、ポップアウトボタンで独立したウィンドウに移せます。並べ替えはできません。ルールを上に移動するには、その上のルールを削除してもう一度追加してください。
あらゆる種類のルール
| ダイアログで | 一致 | ディレクティブ |
|---|---|---|
| 値は NULL です | セルの値が NULL. | when=null |
| 値は NULL ではありません | 値を持つすべてのセル。 | when=not null |
| 値 > … | 値より大きい数値(等しい場合は含まない)。 | when=> N |
| 値 < … | 値より小さい数値(等しい場合は含まない)。 | when=< N |
| …と…の間の値 | 両端を含む範囲内の数値。2 つの値はどちらの順序でも指定できます。 | when=between A and B |
| テキストが次と等しい… | 値と等しいテキスト(大文字小文字は区別しない)。 | when=is TEXT |
| テキストが次を含む… | 値を含むテキスト(大文字小文字は区別しない)。 | when=contains TEXT |
| カラースケール(最小→最大) | すべての数値: 背景色が、列の最小値での Low の色から、最大値での High の色へと変化します。 | scale=#RRGGBB..#RRGGBB |
| データバー | すべての数値: テキストの背後にバーを表示し、列の最小値では空、最大値では満杯になります。 | bar=#RRGGBB |
数値ルール、カラースケール、データバーは、データベースが数値として返したセルだけを対象にします。テキストとして保存されている数値には手を加えず、テキストルールはテキストのセルだけを対象にします。最小値と最大値は、グリッドに読み込まれている行から求めます。列の値がすべて同じ場合は、カラースケールは中間色で塗られ、データバーは全長になります。
どのルールが優先されるか
- ディレクティブのルールが先に適用され、 次にダイアログに保存されたルールが、それぞれ独自の順序で適用されます。
- 最初に一致した値ルールが、そのセルの書式を決めます。 最初に一致したルールのあとはスキップされるため、最も限定的なルールを先頭に置いてください。
- 一致するルールの背景は、カラースケールより優先されます。 テキストの色と太字は、スケールの背景やデータバーとも引き続き組み合わせられます。
- 列ごとに 1 つのカラースケールと 1 つのデータバー: 複数ある場合は、それぞれの最初のものが適用されます。
ルールは列名の大文字小文字を区別せずに照合され、結果内の同じ名前を持つすべての列に適用されます。
保存されたルールまたはディレクティブ
| ダイアログに保存 | conditional: ディレクティブ | |
|---|---|---|
| 適用対象 | すべてのクエリにおいて、その名前の列を持つすべてのグリッド | そのクエリのみ |
| 格納場所: | SQLlyの設定 | クエリテキストなので、ファイルと一緒に持ち運ばれます |
| 向いている用途 | 常に同じ意味を持つ列、たとえば status または error_count | 1 つのレポートの配色を、実行する人全員で共有 |
ダイアログからクエリへ
ダイアログでルールを設定し(設定内容を見ながら進められます)、次をクリックします
ロック 結果名の前に付けます。SQLly は次を書き込みます
conditional: グリッドのその他の設定とともに、結果の列に適用されるルールごとに 1 行を、クエリのロックブロックに書き込みます。ファイルを実行した人は、各自が保存しているルールに関係なく同じ色を見ることになります。
Excel エクスポートで
ある Excel エクスポート または スプレッドシートで開く ルールをExcel標準の条件付き書式としてブックに引き継ぎます: セル値に対する強調ルール、空白およびテキスト含有ルール、2色スケール、データバーで、色と太字も同じです。クエリの conditional: ルールが先に評価され、次に保存済みのルールが評価されます。最初に一致したハイライトルールが引き続き優先されるため、ワークブックはグリッドと同じ見た目になり、誰かが数値を変更しても正しく色付けされ続けます。
ディレクティブを書く
ルールは 1 行に 1 つ。1 つの列にいくつでも行を追加できます:
-- sqlly conditional: column=<name>; <effect>[; <style>…]
効果は when= 条件、1つの scale=、または bar= 上の表から。 when= ルールには少なくとも 1 つのスタイルが必要です: text=#RRGGBB, fill=#RRGGBB、または bold。色にはアルファチャンネルを追加できます(#RRGGBBAA)、そして次の後のテキスト when= 次を含めることはできません ;.
-- sqlly conditional: column=Status; when=is Failed; text=#B00020; bold
-- sqlly conditional: column=Status; when=contains warn; fill=#FFF4CE
-- sqlly conditional: column=Balance; when=< 0; fill=#FDE7E9
-- sqlly conditional: column=Latency; scale=#63BE7B..#F8696B
-- sqlly conditional: column=Revenue; bar=#5B9BD5
-- sqlly conditional: column=ClosedAt; when=null; fill=#FFF4CE80
SELECT Status, Balance, Latency, Revenue, ClosedAt FROM accounts;
段階的にルールを重ねた列です。最初に一致したルールが優先されるため、順序が重要です:
-- sqlly conditional: column=Score; when=> 90; fill=#E3F4E8; text=#1E7B34; bold
-- sqlly conditional: column=Score; when=between 50 and 90; fill=#FFF4CE
-- sqlly conditional: column=Score; when=< 50; fill=#FDE7E9; text=#B00020
スコアがちょうど 90 の場合、一致するのは最初のルールではなく 2 番目のルールです: > そして < は厳格ですが、 between 両端を含みます。