メインコンテンツまでスキップ

Lakebase SQL エディターからのクエリ

備考

ベータ版

6月15日より、LakebaseはGCPでベータとして利用可能です。サポートされているリージョンについては、「リージョンの可用性」を参照してください。

Lakebase SQL エディターは、Lakebase アプリから直接 Lakebase データベースに対してクエリを実行します。EXPLAIN / ANALYZEpsql-styleメタコマンド、CSV/JSON/XLSX への結果のエクスポートなどの Postgres ネイティブ機能を提供します。

注記

また、Lakehouse のSQLエディターから Lakebase データベースをクエリすることもできます。これにより、視覚化、ダッシュボード、コラボレーション機能、Lakebase データを他のUnity Catalogテーブルと組み合わせる機能が提供されます。 SQLエディターからのクエリ (レイクハウス)」を参照してください。

Lakebase SQL エディターを使用する

SQL エディタを使用するには:

  1. Lakebase アプリを開き、プロジェクトを選択します。
  2. サイドバーから SQL エディターを 選択し、ブランチとデータベースを選択します。
  3. エディターにクエリを入力し、 「実行」 をクリックして結果を表示します。

Lakebase SQLエディタ

次のクエリを使用してSQLエディターを試してください。クエリはテーブルを作成し、データを追加し、テーブルからデータを取得します。

SQL
CREATE TABLE IF NOT EXISTS playing_with_lakebase(id SERIAL PRIMARY KEY, name TEXT NOT NULL, value REAL);
INSERT INTO playing_with_lakebase(name, value)
SELECT LEFT(md5(i::TEXT), 10), random() FROM generate_series(1, 10) s(i);
SELECT * FROM playing_with_lakebase;

複数のクエリ ステートメントを一度に実行すると、ステートメントごとに個別の結果セットが返されます。結果セットは実行順に番号が付けられ、個別のタブに表示されます。

エディターをクリアするには、テキスト ボックスの内容を選択して削除します。

説明と分析

Lakebase SQLエディタには、 Explain 機能と Analyze 機能があります。

LKB SQLエディタの説明および分析

  • Explain 機能は、指定されたクエリを Postgres EXPLAIN コマンドで実行し、クエリの実行プランを返します。 Explain 機能は、推定値を含むプランのみを返します。クエリは実行されません。
  • 分析 機能は、EXPLAIN ANALYZEを使用して指定されたクエリを実行します。ANALYZEパラメーターによりクエリが実行され、プラン ノードの実際の行数と実行時間がEXPLAIN推定値とともに返されます。

Explain および Analyze 機能によって提供される情報を理解するには、Postgres EXPLAINコマンドとそのANALYZEパラメーターに精通している必要があります。EXPLAINドキュメントおよびPostgreSQLドキュメントのEXPLAINの使用を参照してください。

データをCSV、JSON、XLSXにエクスポート

Lakebase SQLエディタは、JSONCSVXLSXへのデータのエクスポートをサポートしています。 **SQLエディタ**ページの右下隅からダウンロードボタンにアクセスしてください。 ダウンロードする結果セットがある場合にのみ、ダウンロードボタンが表示されます。

LKB SQLエディタのエクスポート

SQLエディタウィンドウの結果セクションを展開します。

SQL Editor ページの右下にあるウィンドウ展開ボタンを選択して、SQL Editorウィンドウの結果セクションを展開します。

LKB SQLエディタの展開

メタコマンド

Lakebase SQL エディターは、データベースを操作するためのショートカットのように機能する Postgres メタコマンドの使用をサポートしています。psqlコマンドライン インターフェースからのメタコマンドの使用にすでに慣れている場合は、Lakebase SQLエディターで同じコマンドの多くを使用できます。

メタコマンドを使用すると、完全な SQL クエリを記述することなく、データベース スキーマやその他の重要な情報にすばやくアクセスできるようになり、ワークフローを高速化できます。

Lakebase SQL エディター内でよく使用されるメタコマンドを次に示します。

  • \dt — 現在のデータベース内のすべてのテーブルを一覧表示します
  • \d [table_name] — テーブルの構造を説明する
  • \l — すべてのデータベースを一覧表示する
  • \? — 利用可能なメタコマンドのチートシート
  • \h [NAME] — 任意の Postgres コマンドのヘルプを取得します (例: \h SELECT )
注記

すべてのpsqlメタコマンドが SQL エディターでサポートされているわけではありません。サポートされているコマンドのリストを取得するには、 \?を使用します。

メタコマンドとその使用法の完全なリストについては、 「psql のメタコマンド」を参照してください。

メタコマンドの使い方

SQL エディターでメタコマンドを使用するには、エディターにメタコマンドを入力し (SQL クエリと同じように)、 [実行] をクリックします。結果は出力ペインに表示されます。