注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
Ontology SQL は、オントロジーデータに使い慣れた SQL のセマンティクスを適用するために専用設計された、Foundry のオントロジーオブジェクト向け SQL クエリエンジンです。Ontology SQL を使用すると、オブジェクトタイプ、多対多リンク、インターフェースに対して SQL クエリを直接実行できます。標準の Spark SQL 構文を使用してオントロジーオブジェクトをクエリでき、クエリはオブジェクトストレージに対して直接実行されます。Ontology SQL は Foundry の SQL インフラストラクチャを基盤としており、変数、標準 SQL 関数、既存のオントロジーモデリングとのシームレスな統合をサポートする、単一の SELECT 文のインターフェースを提供します。
Ontology SQL は、オントロジーオブジェクトのクエリに統一された SQL の操作環境を提供します。Foundry のほかの SQL 機能と同じ SQL 方言およびフロントエンドの操作環境を共有しつつ、専用のバックエンドで動作します。
SQL Studio または SQL Console のオブジェクトモードで Ontology SQL を操作できます。オブジェクトモードに入ると、標準 SQL 構文を使用してオブジェクトタイプをクエリできます。利用可能な操作の完全なリファレンスについては、SQL 方言のドキュメントを参照してください。
Ontology SQL クエリでは、リソース識別子 (RID) を使用してオブジェクトタイプを参照します。基本構文は次のパターンに従います。
Copied!1SELECT * FROM `ri.ontology.main.object-type.<object-type-rid>`;
たとえば、Employee オブジェクトタイプのすべてのプロパティを取得するクエリは、次のように記述します。
Copied!1SELECT * FROM `ri.ontology.main.object-type.00000000-0000-0000-0000-000000000000`;
多対多リンクのクエリは、次のように記述できます。
Copied!1SELECT * FROM `ri.ontology.main.relation.<relation-rid>`;
クエリでは、すべてのオブジェクトプロパティを表示名ではなくAPI名で参照します。クエリで利用可能な列は、オントロジーで定義されたプロパティのAPI名に直接対応します。プロパティのAPI名は Ontology Manager で確認できます。
たとえば、Employee オブジェクトに employeeId、firstName、department というAPI名のプロパティがある場合、次のようにクエリを記述します。
Copied!1 2SELECT employeeId, firstName, department FROM ri.ontology.main.object-type.<employee-rid>;
一対一および一対多のリンクタイプは、Ontology SQL で使用するために Ontology Manager で定義する必要はありません。SQL を使用して、任意の方法でオブジェクトを結合できます。結合で Ontology Manager に定義されたリンクを使用するかどうかにかかわらず、パフォーマンスは同じです。
多対多リンクには結合テーブルが必要であり、Ontology Manager で定義する必要があります。SQL の結合で使用するには、SQL クエリでリンクタイプを選択する必要があります。
多対多リンクテーブルをクエリする場合、曖昧さを避けるため、列名は特定の規則に従います。
各外部キー列には、次のパターンで名前が付けられます。
<objectTypeApiName>_<relationApiName>
Person オブジェクトと Car オブジェクト間の多対多の関係を考えます。
オントロジーの設定は次のとおりです。
Person(API名:person)
personIdPerson 側のリンクのAPI名: vehiclesCar(API名:car)
carIdCar 側のリンクのAPI名: driversri.ontology.main.relation.0次に、特定の人物が運転するすべての車を検索するクエリの例を示します。
Copied!1 2 3 4 5SELECT c.* FROM `ri.ontology.main.relation.0` AS linkTable INNER JOIN `car` AS c ON c.`carId` = linkTable.`person_vehicles` WHERE linkTable.`car_drivers` = 'person-123';
また、特定の車を運転するすべての人物を検索するクエリの例を示します。
Copied!1 2 3 4 5SELECT p.* FROM `ri.ontology.main.relation.0` AS linkTable INNER JOIN `person` AS p ON p.`personId` = linkTable.`car_drivers` WHERE linkTable.`person_vehicles` = 'car-456';
多対多リンクを操作する場合は、必ずテーブルのエイリアスを使用してください。エイリアスがないと、列名が読みにくくなり、保守が難しくなることがあります。次の例を比較してください。
エイリアスあり(推奨):
Copied!1 2 3 4SELECT c.* FROM `ri.ontology.main.relation.0` AS linkTable INNER JOIN car AS c ON c.carId = linkTable.person_vehicles WHERE linkTable.car_drivers = 'person-123';
エイリアスなし(読みにくい):
Copied!1 2 3 4SELECT car.* FROM `ri.ontology.main.relation.0` INNER JOIN car ON car.carId = `ri.ontology.main.relation.0`.person_vehicles WHERE `ri.ontology.main.relation.0`.car_drivers = 'person-123';
Ontology SQL は、DECLARE 文による変数の使用をサポートしています。
Copied!1 2 3 4 5DECLARE @minSalary DOUBLE = 75000.0, @department STRING = 'Engineering'; SELECT employeeId, salary FROM ri.ontology.main.object-type.<employee-rid> WHERE salary > @minSalary AND department = @department;
DECLARE 文はクエリの最初の文である必要があり、1回しか使用できません。複数の変数を宣言する方法については、上の例を参照してください。SET 文は使用できません。次の Palantir 独自の構文を使用して、オブジェクトセット変数を定義できます。
Copied!1 2 3 4DECLARE @employees `ri.ontology.main.object-type.<object-type-rid>`; SELECT employeeId FROM @employees;
INT や STRING などの変数のデータ型を指定する代わりに、オブジェクトタイプの RID をバッククォートで囲んで記述します。これにより、オブジェクトセットの形式が強制されます。オブジェクトセット変数のデフォルト値は、指定されたタイプのすべてのオブジェクトであり、上書きできません。
user や result など、一部のキーワードは予約されています。競合を避けるため、次に示すように列名をバッククォートで囲むことを推奨します。
Copied!1SELECT `user`, `result` FROM ri.ontology.main.object-type.<object-rid>;
WHERE 句の列に関数や変換を適用する場合、または計算列を使用して絞り込む場合、クエリエンジンはインデックスを活用できません。これにより、クエリのパフォーマンスと計算の規模が大幅に制限されます。
インデックスを使用できなくなる次のパターンは避けてください。
Copied!1 2 3 4 5 6 7 8 9-- 計算列で絞り込みます SELECT employeeId, salary, bonus FROM employee WHERE salary + bonus > 100000; -- 関数の結果で絞り込みます SELECT employeeId, hireDate FROM employee WHERE YEAR(hireDate) = 2023;
インデックスを使用できる次のパターンを優先してください。
Copied!1 2 3 4 5 6 7 8 9-- 元の列で直接絞り込みます SELECT employeeId, salary, bonus FROM employee WHERE salary > 100000 - bonus; -- 年を抽出する代わりに日付範囲の比較を使用します SELECT employeeId, hireDate FROM employee WHERE hireDate >= '2023-01-01' AND hireDate < '2024-01-01';
同じ原則が集計にも当てはまります。クエリのいずれかの部分で変換された列(たとえば、colA + colB AS newColumn)を対象に絞り込むと、エンジンはインデックスを使用して一致する行を効率的に特定できず、パフォーマンスが低下します。
必要がない場合は、クエリでベクトル(埋め込み)などの大きい列を選択しないでください。これらの列は、分析に不要な場合には価値をもたらさず、クエリの実行時間とメモリー使用量を大幅に増加させる可能性があります。
SELECT クエリのみ: Ontology SQL は読み取り操作のみに対応しています。データ変更(INSERT、UPDATE、DELETE)やスキーマ定義(CREATE、ALTER、DROP`)の操作は利用できません。SELECT 文: 変数用の DECLARE 文を除き、1つのクエリで使用できる SELECT 文は1つのみです。OFFSET + LIMIT が10,000以下であれば、OFFSET を使用できます。たとえば、OFFSET 1000 LIMIT 1000 は機能しますが、OFFSET 9000 LIMIT 2000 は機能しません。アプリケーションを使用して Ontology SQL を操作する場合、それぞれのアプリケーションでより厳しい制限が適用されることがあります。NotEnoughSparkResources エラーが発生します。| 機能 | サポート状況 |
|---|---|
| オブジェクトタイプ | サポートされています。オブジェクトタイプを Ontology Manager で定義する必要があります |
| 多対多のリンク | サポートされています。リンクタイプを Ontology Manager で定義する必要があります |
| インターフェース | サポートされています |
| 一対一および一対多のリンク | サポートされています。Ontology Manager でリンクタイプを定義する必要がないため、Ontology SQL で直接使用できます |
| ブランチ分岐 | サポートされています |
| シナリオ | サポートされています |
| 書き込み操作 | 利用できません |