注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

オントロジー SQL 関数

ベータ版

オントロジー SQL 関数は開発のベータ版段階にあり、一部の機能はお使いの環境で利用できない場合があります。開発が活発に進められている間は、機能が変更される可能性があります。ベータ機能の利用をご希望の場合は、Palantir サポートにお問い合わせください。

オントロジー SQL 関数を使用すると、SQL を使ってオントロジーのオブジェクトに対する、再利用可能なパラメーター付きクエリを定義できます。公開すると、オントロジー SQL 関数は、Workshop、Actions、Automate、オントロジー SDK など、Foundry 内でオントロジー関数を受け付けるあらゆる場所で使用できます。

オントロジー SQL 関数は読み取り専用です。オントロジー SQL 関数内からオントロジーを変更することはできません。

ベータ版のオントロジー SQL 関数は、現在、多数の同時実行を伴うワークロードをサポートしていません。利用可能なリソースが少ない場合はキューで待機する必要が生じたり、負荷がかかると失敗したりする可能性があります。クエリとデータに関するその他の制約については、オントロジー SQL の制限と制約を参照してください。

SQL で関数を定義する

オントロジー SQL 関数は SQL Studio で記述できます。関数を作成するには、オブジェクトモードにする必要があります。

関数はパラメーターをサポートしており、SQL 方言の変数を使用して宣言します。次の例では、animalParam は関数の呼び出し時に渡されるパラメーターです。エディターでクエリをテストするときは、デフォルト値の 'dog' が使用されます。

リテラルパラメーターに格納できるのは、オントロジー SQL 方言がサポートするデータ型のリテラル値（たとえば、文字列、数値、ブール値）のみです。パラメーターに SQL の断片や式を含めることはできず、WHERE 句の比較の右辺など、SQL 方言がリテラル値を必要とする位置でのみ使用できます。

ObjectSet パラメーターは FROM 句でのみ使用できます。

Copied!1
2
3
4
5
DECLARE @animalParam STRING = 'dog';

SELECT *
FROM `ri.ontology.main.object-type...`
WHERE animaltype = @animalParam;

関数を公開する

関数の内容に問題がなければ、ワークシートを保存し、公開ボタンを選択します。関数を公開するには、事前にワークシートをプロジェクトに保存する必要があります。

関数を公開ダイアログで、Foundry のほかの関数と同様に、関数の名前と API 名を入力します。

関数を使用する

オントロジー SQL 関数は、選択した列にフィールドが対応する構造体のリストを返します。結果の各行に対して1個の構造体が返されます。列を1列だけ選択した場合は、代わりにその列のデータ型のリストを返します。たとえば、SELECT animal, animalType, age FROM ... は List<Struct<animal: STRING, animalType: STRING, age: INTEGER>> を返し、SELECT animal FROM ... は List<STRING> を返します。

関数を公開すると、ほかのオントロジー関数と同様に、Workshop、Actions、Automate、オントロジー SDK など、Foundry 全体で使用できます。オントロジー SQL 関数は、TypeScript 関数や Python 関数から呼び出すこともできます。Foundry のほかの関数と同様に、オントロジー SQL 関数はブランチおよびシナリオに対するクエリをサポートしています。

オントロジー SQL 全般の詳細については、オントロジー SQL の概要を参照してください。