オントロジーの構築Object Explorerオブジェクトの検索SQLを使用した分析

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

SQL を使用してオブジェクトを分析する [ベータ版]

ベータ版

オントロジーの SQL サポートは開発のベータ版段階にあり、お使いのエンロールメントでは利用できない場合があります。開発が進行している間は、機能が変更される可能性があります。オントロジーの SQL を有効にするには、Palantir サポートにお問い合わせください。

SQL を使用して分析する機能を使用して、オブジェクトタイプの簡単な分析を表示できます。この機能は SQL の「スクラッチパッド」で構成されており、読み取り専用の SQL クエリを実行できます。データセットプレビューと同様に、次の機能をサポートしています。

  • オブジェクトタイプの RID の自動入力
  • バッククォート( ` )内でほかのオブジェクトタイプを検索し、効率的な JOIN クエリを実行
  • キーボードショートカットなど、エディターでの作業を容易にする機能を使用して、ハイライトされたクエリを実行
  • 実行した SQL クエリの結果をプレビューテーブルに出力
  • 列と下部パネルのサイズを好みに合わせて変更

SQL を使用した分析を行うには、次の手順に従います。

  1. 探索を開きます。
  2. 右上のメニューでSQL を使用して分析するを選択して、サイズ調整可能なプレビューパネルを開きます。
  3. コードタブで、データセットに対する読み取り専用のクエリを記述します。

「SQL を使用して分析する」機能の使用例。

クエリ内で名前を入力すると、任意のオブジェクトタイプを検索できます。オートコンプリートウィンドウが表示され、オブジェクトタイプをすばやく選択して完全な RID を自動入力できます。

オブジェクトの RID の自動入力の例

または、次の構文でオブジェクトタイプのAPI名を使用できます。

Copied!
1 `ontologyApiName`.`objectTypeApiName`

オブジェクトのAPI名を使用したクエリの例。

多対多のリンクタイプに対してクエリを実行するには、リンクタイプの RID をバッククォートで囲んで(`RID`)使用できます。

要件

SQL を使用した分析では、オントロジーリソースの元データソースまたは実体化に対してクエリを実行します。次の要件に注意してください。

  • 編集が無効になっているオントロジーリソースには、データソースが1個だけ必要です。
  • 編集が有効になっているリソース、編集専用のプロパティを持つリソース、または複数のデータソースを持つリソースには、実体化が必要です。

これらの要件を満たさないオントロジーの入力に対してクエリを実行しようとすると、コードエディターに警告が表示されます。

オブジェクトタイプに実体化が必要であることを示すコードエディターの警告のサンプル。

同じクエリ内で、テーブル形式のソース(データセット、テーブル、制限付きビューなど)とオントロジーの入力を混在させることはできません。

データの鮮度

編集が有効になっているオブジェクトの場合、SQL を使用した分析ではリソースの実体化に対してクエリを実行します。そのため、オブジェクトに対して実行した編集やアクションなどの最近の変更がクエリ結果に反映されるまで、最大30秒かかる場合があります。コードエディターでは、このデータの鮮度に関する時間差についてのリマインダーが出力テーブルの上に表示されます。

互換性

SQL エンジンは Spark SQL 方言をサポートしています。Spark SQL では、テーブル名などの識別子は、シングルクォートやダブルクォートではなく、バッククォート( ` )で囲む必要があります。

次の例は、この構文を示しています。

Copied!
1 SELECT column_name FROM \`ri.ontology.main.object-type...\`;

Spark SQL 方言とその構文の詳細については、Spark SQL の公式ドキュメント ↗を参照してください。

クエリ実行の詳細と制限

  1. 各クエリはデータセット全体に対して実行され、Contour と同じコンピューティングバックエンドを使用します。
  2. 各クエリは最大1,000行のサンプルを返します。
  3. SQL コンソールの使用量は、リソース管理で、Contour というラベルの付いたソースの下に、データセットレベルで計上されます。