SQL Studio

SQL Studio は、データセット、テーブル、オントロジーのオブジェクトタイプに対する SQL クエリの記述と実行に特化した Foundry のアプリケーションです。SQL Studio は、対話型の分析ワークフロー、表形式データの読み取りと書き込み操作、および Ontology SQL 関数（ベータ版）の開発をサポートします。

SQL Studio は、Foundry の2つの SQL エンジンを基盤としています。オントロジーのオブジェクトタイプをクエリする Ontology SQL と、表形式データをクエリする Furnace です。これらは共通の Spark SQL 方言を使用します。特定のリソース（データセットやオブジェクトタイプなど）のコンテキストで埋め込みの SQL アクセスを使用する場合は、SQL コンソールを参照してください。

SQL Studio にアクセスする

Foundry 管理者が有効にすると、次の場所から SQL Studio にアクセスできます。

• アプリケーションメニュー。
• 埋め込みの SQL コンソールの展開オプション。
• Compass ブラウザーで SQL ワークシートを開く。

SQL Studio を有効にするには、Foundry 管理者は Control Panel のアプリケーションへのアクセスページに移動します。

モード

SQL Studio は2つのモードをサポートしています。モードによって、クエリを実行するコンピューティングエンジンと、クエリ可能なリソースが決まります。

リソースブラウザーのツールバーにあるモードセレクターで、モードを切り替えられます。アクティブなモードによって、ブラウザーに表示されるリソースと、クエリを実行するエンジンが決まります。

データモード

データモードでは、Furnace SQL エンジンを使用して、表形式のデータセット、Iceberg テーブル、仮想テーブルなどの表形式データをクエリできます。

データモードは、読み取り操作と書き込み操作の両方をサポートします。

• SELECT クエリ。
• CREATE TABLE 操作。
• Iceberg テーブルに対する INSERT、UPDATE、DELETE 操作。

Furnace SQL の出力は、複数の SQL 定義を保持でき、そのうち1つのアクティブな定義が、スケジュールされた再ビルドとオンデマンドの再ビルドに使用されます。

オブジェクトモード

オブジェクトモードでは、Ontology SQL エンジンを使用して、オントロジーのオブジェクトタイプと多対多リンクをクエリできます。オブジェクトモードは読み取り専用で、Ontology Manager で定義されたオブジェクトタイプに対する SELECT クエリをサポートします。

ワークシート

ワークシートは、SQL Studio で作業を整理するための主要な手段です。一時的な分析にはスクラッチパッドを使用でき、ワークシートを非公開で保存したり、プロジェクトに保存して共有したりできます。保存済みのワークシートはバージョン履歴をサポートし、未保存の変更はセッション間で自動的に保持されます。詳細は、SQL ワークシートを参照してください。

クエリを記述して実行する

SQL Studio は、データモードとオブジェクトモードの両方で、Foundry の Spark SQL 方言を使用します。エディターには、構文のハイライト、テーブル名、オブジェクトタイプ名、列名の自動補完、およびインラインのエラー表示機能があります。

クエリを実行するには、エディターのツールバーで実行を選択するか、キーボードショートカットを使用します。クエリの一部のみを実行するには、該当する SQL を選択し、選択範囲を実行します。

データモードでは、テーブル識別子は、バッククォートで囲んだファイルシステムパスまたはリソース識別子（RID）で参照します。

Copied!
1
SELECT * FROM `branch_name`.`/path/to/dataset`;

オブジェクトモードでは、オブジェクトタイプは RID で参照します。

Copied!
1
SELECT * FROM `ri.ontology.main.object-type.<object-type-rid>`;

構文の詳細については、SQL 方言のドキュメントを参照してください。モードごとのガイダンスについては、Furnace と Ontology SQL を参照してください。

AI によるクエリ生成支援

SQL Studio には、SQL クエリの生成、説明、デバッグができる対話型の AIP サイドパネルが含まれています。このパネルはエディターの横で利用でき、1つのセッション内で複数ターンのインタラクションをサポートします。

AIP パネルは、次の情報にアクセスできます。

• エディターの現在の内容。
• クエリで参照されているデータセット、テーブル、オブジェクトタイプのスキーマ。
• アクティブなモードでサポートされる関数と構文を含む、Foundry の SQL 方言。

SQL の生成時に、パネルはエディターの内容を新しいコードに置き換えるか、既存のクエリに追加できます。プロンプトとレスポンスはそれぞれセッション内に保持されるため、対話を通じて生成された出力を繰り返し改善できます。

AIP サイドパネルは、AIP およびコアアシスタント機能の権限が有効なユーザーに利用可能です。

結果をプレビューして可視化する

クエリを実行すると、エディターの下にある結果パネルに結果が表示されます。

デフォルトのプレビュー上限は1,000行です。適切な権限を持つユーザーは、SQL Studio の設定メニューから、クエリごとに最大10,000行を返すように SQL Studio を設定できます。

結果は、テーブルまたはチャートとして可視化できます。どちらの可視化にもプレビュー上限が適用されます。たとえば、クエリに一致する行が100,000行ある場合、デフォルトでは最初の1,000行のみがテーブルまたはチャートに表示されます。

Ontology SQL 関数

SQL Studio から Ontology SQL 関数（ベータ版）を開発して公開できます。Ontology SQL 関数は、オントロジーのオブジェクトに対する再利用可能なパラメーター付き SQL クエリです。オントロジー関数として公開し、Foundry 全体から呼び出すことができます。

外部ツールを接続する

Furnace エンジンで表形式データをクエリする場合は、次の方法で外部から接続することもできます。

• Arrow Flight SQL、または
• REST API

Ontology SQL エンジンでオブジェクトタイプをクエリする場合は、Ontology MCP サーバーを使用して外部から接続できます。このサーバーは、MCP に対応するクライアントに Ontology SQL を公開します。

ロールと権限

SQL Studio へのアクセスは、Foundry 全体で適用されるものと同じ SQL ロールおよびダウンロード制御ロールによって管理されます。利用可能なロールと、それらが SQL アクセスにどのように影響するかについては、SQL 権限を参照してください。