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

SQL 権限

このページでは、SQL Studio、埋め込みの SQL コンソール、Arrow Flight SQL または SQL REST API 経由で接続された外部 SQL クライアントなど、Foundry の SQL 機能へのアクセスを管理するロールについて説明します。

ここで説明するロールは、Foundry SQL Server およびダウンロードのロールセットカテゴリーに属します。

関連する操作権限

次の操作権限で SQL アクセスを制御します。リソースに対して SQL を実行するには、ユーザーはそのリソースに対する foundry-sql-server:preview または foundry-sql-server:read の操作権限を1つ以上持っている必要があります。

SQL 操作権限は、基盤となるリソースへのアクセスを付与しません。ユーザーは、クエリが参照するすべてのリソースを読み取りまたは変更するために必要な通常の権限も持っている必要があります。

操作権限	Foundry の動作	外部 API の動作
プレビュー: `foundry-sql-server:preview`	結果プレビューは、クエリ結果の最初の1,000行を返します。	-
クエリ: `foundry-sql-server:read`	結果プレビューのデフォルトは1,000行です。SQL Studio では、設定メニューからプレビューの上限を10,000行に拡張できます。	行数の上限なしでクエリ結果全体を返します。
ダウンロード: `foundry-sql-server:frontend-download`	結果パネルのダウンロードアクションに必要です。結果プレビューに表示されている行（最大1,000行）をダウンロードします。	—
ワークシートの読み取り: `foundry-sql-server:read-worksheet`	保存済みの SQL ワークシートを開いて閲覧します。	—
ワークシートの書き込み: `foundry-sql-server:write-worksheet`	SQL ワークシートを作成、編集、保存します。	—

これらの操作権限は、デフォルトのロールセットの一部として、またはカスタムロールセット内のカスタムロールを通じて付与できます。

オントロジー SQL を使用してオントロジーをクエリする場合、追加のロールは必要ありません。アクセスには、クエリ対象のオブジェクトタイプに対する標準のオントロジーロールが適用されます。

デフォルトロールは、カスタムロールセットを通じてカスタマイズできます。一般的な設定には次のようなものがあります。

クエリの制限： 一部の組織では、ユーザーが SQL API 経由で上限のないクエリを実行することを防ぐために、SQL を使用したデータセットのクエリを制限しています。この場合でも、SQL を使用したデータセットのプレビューを付与して、ユーザーが Foundry 内で上限付きのクエリを実行できるようにすることは可能です。
ダウンロードとクエリの分離： 一部の組織では、プレビュー権限が付与されているユーザーであっても、UI のダウンロードボタンから結果をダウンロードできないようにするために、Foundry での SQL 結果のダウンロードを制限しています。

AI 支援によるクエリ生成機能の利用可否は、ロールセットの権限ではなく、AIP が有効になっているかどうかによって決まります。

ユーザーの組織と、クエリ対象のリソースを含むプロジェクトで、AIP が有効になっている必要があります。詳細については、AIP 権限を参照してください。