Items - List KQL Databases
指定したワークスペースから KQL データベースの一覧を返します。
この API では、改ページがサポートされています。
権限
呼び出し元には ビューアー ワークスペース ロールが必要です。
必要な委任されたスコープ
Workspace.Read.All または Workspace.ReadWrite.All
Microsoft Entra でサポートされている ID
この API では、このセクションに記載されている Microsoft ID がサポートされています。
| 同一性 | 支える |
|---|---|
| 利用者 | はい |
| サービス プリンシパルの とマネージド ID の | はい |
インターフェイス
GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/kqlDatabases
GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/kqlDatabases?continuationToken={continuationToken}
URI パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
workspace
|
path | True |
string (uuid) |
ワークスペース ID。 |
|
continuation
|
query |
string |
結果の次のページを取得するためのトークン。 |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 200 OK |
要求は正常に完了しました。 |
|
| Other Status Codes |
一般的なエラー コード:
|
例
List KQL databases in workspace example
要求のサンプル
GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/kqlDatabases
応答のサンプル
{
"value": [
{
"id": "3546052c-ae64-4526-b1a8-52af7761426f",
"displayName": "KQLDatabase_1",
"description": "A KQL database description.",
"type": "KQLDatabase",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"properties": {
"parentEventhouseItemId": "6a437a7c-1a28-4fd0-a362-11308b94c79b",
"queryServiceUri": "https://trd-f7k1b2rzuqrjmb3wpd.z5.kusto.fabric.microsoft.com",
"ingestionServiceUri": "https://ingest-trd-f7k1b2rzuqrjmb3wpd.z5.kusto.fabric.microsoft.com",
"databaseType": "ReadWrite"
}
},
{
"id": "340d91b9-5a39-409c-b9c0-05ba832c476e",
"displayName": "KQLDatabase_2",
"description": "A KQL database description.",
"type": "KQLDatabase",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"properties": {
"parentEventhouseItemId": "9add9a4d-079a-432a-b43a-70c899f2087b",
"queryServiceUri": "https://trd-f7k1b2rzuqrjmb3wpd.z5.kusto.fabric.microsoft.com",
"ingestionServiceUri": "https://ingest-trd-f7k1b2rzuqrjmb3wpd.z5.kusto.fabric.microsoft.com",
"databaseType": "ReadWrite"
}
}
]
}
定義
| 名前 | 説明 |
|---|---|
|
Error |
エラー関連のリソース詳細オブジェクト。 |
|
Error |
エラー応答。 |
|
Error |
エラー応答の詳細。 |
|
Item |
アイテムに適用されるタグを表します。 |
|
Item |
アイテムの種類。 追加の項目の種類は、時間の経過と同時に追加される場合があります。 |
| KQLDatabase |
KQL データベース オブジェクト。 |
|
KQLDatabase |
KQL データベースのプロパティ。 |
| KQLDatabases |
KQL データベースの一覧。 |
|
Kql |
データベースの型。 |
ErrorRelatedResource
エラー関連のリソース詳細オブジェクト。
| 名前 | 型 | 説明 |
|---|---|---|
| resourceId |
string |
エラーに関係するリソース ID。 |
| resourceType |
string |
エラーに関係するリソースの種類。 |
ErrorResponse
エラー応答。
| 名前 | 型 | 説明 |
|---|---|---|
| errorCode |
string |
エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。 |
| message |
string |
エラーの人間が判読できる表現。 |
| moreDetails |
その他のエラーの詳細の一覧。 |
|
| relatedResource |
エラー関連のリソースの詳細。 |
|
| requestId |
string |
エラーに関連付けられている要求の ID。 |
ErrorResponseDetails
エラー応答の詳細。
| 名前 | 型 | 説明 |
|---|---|---|
| errorCode |
string |
エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。 |
| message |
string |
エラーの人間が判読できる表現。 |
| relatedResource |
エラー関連のリソースの詳細。 |
ItemTag
アイテムに適用されるタグを表します。
| 名前 | 型 | 説明 |
|---|---|---|
| displayName |
string |
タグの名前。 |
| id |
string (uuid) |
タグ ID。 |
ItemType
アイテムの種類。 追加の項目の種類は、時間の経過と同時に追加される場合があります。
| 値 | 説明 |
|---|---|
| Dashboard |
PowerBI ダッシュボード。 |
| Report |
PowerBI レポート。 |
| SemanticModel |
PowerBI セマンティック モデル。 |
| PaginatedReport |
PowerBI のページ分割されたレポート。 |
| Datamart |
PowerBI データマート。 |
| Lakehouse |
レイクハウス。 |
| Eventhouse |
イベントハウス。 |
| Environment |
環境。 |
| KQLDatabase |
KQL データベース。 |
| KQLQueryset |
KQL クエリセット。 |
| KQLDashboard |
KQL ダッシュボード。 |
| DataPipeline |
データ パイプライン。 |
| Notebook |
ノートブック。 |
| SparkJobDefinition |
Spark ジョブ定義。 |
| MLExperiment |
機械学習の実験。 |
| MLModel |
機械学習モデル。 |
| Warehouse |
倉庫。 |
| Eventstream |
イベントストリーム。 |
| SQLEndpoint |
SQL エンドポイント。 |
| MirroredWarehouse |
ミラー化された倉庫。 |
| MirroredDatabase |
ミラー化されたデータベース。 |
| Reflex |
反射。 |
| GraphQLApi |
GraphQL 項目の API。 |
| MountedDataFactory |
MountedDataFactory。 |
| SQLDatabase |
SQLDatabase。 |
| CopyJob |
コピー ジョブ。 |
| VariableLibrary |
VariableLibrary。 |
| Dataflow |
データフロー。 |
| ApacheAirflowJob |
ApacheAirflowJob。 |
| WarehouseSnapshot |
Warehouse スナップショット。 |
| DigitalTwinBuilder |
DigitalTwinBuilder。 |
| DigitalTwinBuilderFlow |
デジタル ツイン ビルダー フロー。 |
| MirroredAzureDatabricksCatalog |
ミラー化された Azure databricks カタログ。 |
| Map |
マップ。 |
| AnomalyDetector |
Anomaly Detector。 |
| UserDataFunction |
ユーザー データ関数。 |
| GraphModel |
GraphModel。 |
| GraphQuerySet |
Graph QuerySet。 |
| SnowflakeDatabase |
Snowflake アカウントから作成された Iceberg テーブルを格納する Snowflake データベース。 |
| OperationsAgent |
OperationsAgent。 |
KQLDatabase
KQL データベース オブジェクト。
| 名前 | 型 | 説明 |
|---|---|---|
| description |
string |
アイテムの説明。 |
| displayName |
string |
アイテムの表示名。 |
| folderId |
string (uuid) |
フォルダー ID。 |
| id |
string (uuid) |
アイテム ID。 |
| properties |
KQL データベースのプロパティ。 |
|
| tags |
Item |
適用されたタグの一覧。 |
| type |
アイテムの種類。 |
|
| workspaceId |
string (uuid) |
ワークスペース ID。 |
KQLDatabaseProperties
KQL データベースのプロパティ。
| 名前 | 型 | 説明 |
|---|---|---|
| databaseType |
データベースの型。 |
|
| ingestionServiceUri |
string |
インジェスト サービス URI。 |
| parentEventhouseItemId |
string |
親イベントハウス ID。 |
| queryServiceUri |
string |
クエリ サービス URI。 |
KQLDatabases
KQL データベースの一覧。
| 名前 | 型 | 説明 |
|---|---|---|
| continuationToken |
string |
次の結果セット バッチのトークン。 これ以上レコードがない場合は、応答から削除されます。 |
| continuationUri |
string |
次の結果セット バッチの URI。 これ以上レコードがない場合は、応答から削除されます。 |
| value |
KQL データベースの一覧。 |
KqlDatabaseType
データベースの型。
| 値 | 説明 |
|---|---|
| ReadWrite |
データベースに対する読み取り操作と書き込み操作を許可します。 |
| Shortcut |
ショートカットは、ソース データベースに対する読み取り専用操作を許可する埋め込み参照です。 ソースは、Azure Data Explorer クラスターまたは Fabric Eventhouse 内の同じテナントまたは異なるテナントに配置できます。 |