SQL の例

このページでは、表形式データの読み書きやオントロジーのオブジェクトタイプへのクエリなど、Foundry でよく行うタスクの実践的な SQL の例を紹介します。例は、SQL Studio、埋め込みの SQL コンソール、または Arrow Flight SQL 経由で接続された外部 SQL クライアントから実行できます。構文の詳細については、SQL 方言のドキュメントを参照してください。

表形式データ

以下の例では、データモードでデータセットと Iceberg テーブルに対してクエリと変更を行います。これらは Furnace エンジンによって実行されます。

データセットを作成して読み取る

Copied!
1
2
3
4
5
6
7
8
9
-- データセットを作成する
CREATE OR REPLACE TABLE `/path/dataset-name` USING parquet AS
SELECT *
FROM `/path/dataset-input`;

-- データセットをクエリする
SELECT *
FROM `/path/dataset-name`
WHERE column = 'value';

Iceberg テーブルを作成して変更する

Copied!
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
-- 空の Iceberg テーブルを作成する
CREATE TABLE `/path/table-name` (
    id   INT,
    name STRING
)
USING iceberg;

-- 行を挿入する
INSERT INTO `/path/table-name`
VALUES (1, 'apple'), (2, 'pear');

-- 行を更新する
UPDATE `/path/table-name`
SET name = 'clementine'
WHERE id = 2;

-- 行を削除する
DELETE FROM `/path/table-name`
WHERE id = 1;

オントロジーのオブジェクトタイプ

以下の例では、オブジェクトモードでオントロジーのオブジェクトタイプに対してクエリを行います。これらは Ontology SQL エンジンによって実行されます。オブジェクトタイプは、リソース識別子（RID）で参照します。

オブジェクトタイプにクエリを行う

Copied!
1
2
3
SELECT employeeId, firstName, department
FROM `ri.ontology.main.object-type.<employee-rid>`
WHERE department = 'Engineering';

多対多のリンクにクエリを行う

Copied!
1
2
3
4
5
6
-- 特定の人物が運転するすべての車を検索する
SELECT c.*
FROM `ri.ontology.main.relation.<relation-rid>` AS linkTable
INNER JOIN `car` AS c
  ON c.`carId` = linkTable.`person_vehicles`
WHERE linkTable.`car_drivers` = 'person-123';

リンクテーブルの列の規則や、その他のオブジェクトへのクエリパターンの詳細については、Ontology SQL のドキュメントを参照してください。

トラブルシューティング

Output folder is not enabled for Iceberg tables. Please use a different format. などのエラーが表示される場合、サポートされていない場所に Iceberg テーブルを書き込もうとしている可能性があります。このエラーは、お使いの環境、または書き込み先の特定のプロジェクトの場所で Iceberg テーブルが有効になっていないことを示します。別のデータ形式（たとえば USING parquet）で書き込むようにコードを変更するか、Palantir サポートにお問い合わせのうえ、Foundry の Iceberg テーブルを有効にしてください。