Items - Get KQL Database
指定した KQL データベースのプロパティを返します。
権限
呼び出し元には、ビューアー 以上のワークスペース ロールが必要です。
必要な委任されたスコープ
KQLDatabase.Read.All または KQLDatabase.ReadWrite.All または Item.Read.All または Item.ReadWrite.All
Microsoft Entra でサポートされている ID
この API では、このセクションに記載されている Microsoft ID がサポートされています。
| 同一性 | 支える |
|---|---|
| 利用者 | はい |
| サービス プリンシパルの とマネージド ID の | はい |
インターフェイス
GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/kqlDatabases/{kqlDatabaseId}URI パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
kql
|
path | True |
string uuid |
KQL データベース ID。 |
|
workspace
|
path | True |
string uuid |
ワークスペース ID。 |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 200 OK |
要求は正常に完了しました。 |
|
| Other Status Codes |
一般的なエラー コード:
|
例
Get a KQL database example
要求のサンプル
GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/kqlDatabases/5b218778-e7a5-4d73-8187-f10824047715
応答のサンプル
{
"displayName": "KQLDatabase_1",
"description": "A KQL database description.",
"type": "KQLDatabase",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"id": "5b218778-e7a5-4d73-8187-f10824047715",
"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"
}
}定義
| 名前 | 説明 |
|---|---|
|
Error |
エラー関連のリソース詳細オブジェクト。 |
|
Error |
エラー応答。 |
|
Error |
エラー応答の詳細。 |
|
Item |
アイテムの種類。 追加の項目の種類は、時間の経過と同時に追加される場合があります。 |
| KQLDatabase |
KQL データベース オブジェクト。 |
|
KQLDatabase |
KQL データベースのプロパティ。 |
|
Kql |
データベースの型。 |
ErrorRelatedResource
エラー関連のリソース詳細オブジェクト。
| 名前 | 型 | 説明 |
|---|---|---|
| resourceId |
string |
エラーに関係するリソース ID。 |
| resourceType |
string |
エラーに関係するリソースの種類。 |
ErrorResponse
エラー応答。
| 名前 | 型 | 説明 |
|---|---|---|
| errorCode |
string |
エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。 |
| message |
string |
エラーの人間が判読できる表現。 |
| moreDetails |
その他のエラーの詳細の一覧。 |
|
| relatedResource |
エラー関連のリソースの詳細。 |
|
| requestId |
string |
エラーに関連付けられている要求の ID。 |
ErrorResponseDetails
エラー応答の詳細。
| 名前 | 型 | 説明 |
|---|---|---|
| errorCode |
string |
エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。 |
| message |
string |
エラーの人間が判読できる表現。 |
| relatedResource |
エラー関連のリソースの詳細。 |
ItemType
アイテムの種類。 追加の項目の種類は、時間の経過と同時に追加される場合があります。
| 値 | 説明 |
|---|---|
| Dashboard |
PowerBI ダッシュボード。 |
| DataPipeline |
データ パイプライン。 |
| Datamart |
PowerBI データマート。 |
| Environment |
環境。 |
| Eventhouse |
イベントハウス。 |
| Eventstream |
イベントストリーム。 |
| GraphQLApi |
GraphQL 項目の API。 |
| KQLDashboard |
KQL ダッシュボード。 |
| KQLDatabase |
KQL データベース。 |
| KQLQueryset |
KQL クエリセット。 |
| Lakehouse |
レイクハウス。 |
| MLExperiment |
機械学習の実験。 |
| MLModel |
機械学習モデル。 |
| MirroredDatabase |
ミラー化されたデータベース。 |
| MirroredWarehouse |
ミラー化された倉庫。 |
| MountedDataFactory |
MountedDataFactory。 |
| Notebook |
ノートブック。 |
| PaginatedReport |
PowerBI のページ分割されたレポート。 |
| Reflex |
反射。 |
| Report |
PowerBI レポート。 |
| SQLDatabase |
SQLDatabase。 |
| SQLEndpoint |
SQL エンドポイント。 |
| SemanticModel |
PowerBI セマンティック モデル。 |
| SparkJobDefinition |
Spark ジョブ定義。 |
| Warehouse |
倉庫。 |
KQLDatabase
KQL データベース オブジェクト。
| 名前 | 型 | 説明 |
|---|---|---|
| description |
string |
アイテムの説明。 |
| displayName |
string |
アイテムの表示名。 |
| id |
string uuid |
アイテム ID。 |
| properties |
KQL データベースのプロパティ。 |
|
| type |
アイテムの種類。 |
|
| workspaceId |
string uuid |
ワークスペース ID。 |
KQLDatabaseProperties
KQL データベースのプロパティ。
| 名前 | 型 | 説明 |
|---|---|---|
| databaseType |
データベースの型。 |
|
| ingestionServiceUri |
string |
インジェスト サービス URI。 |
| parentEventhouseItemId |
string |
親イベントハウス ID。 |
| queryServiceUri |
string |
クエリ サービス URI。 |
KqlDatabaseType
データベースの型。
| 値 | 説明 |
|---|---|
| ReadWrite |
データベースに対する読み取り操作と書き込み操作を許可します。 |
| Shortcut |
ショートカットは、ソース データベースに対する読み取り専用操作を許可する埋め込み参照です。 ソースは、Azure Data Explorer クラスターまたは Fabric Eventhouse 内の同じテナントまたは異なるテナントに配置できます。 |