Items - Get KQL Database
Retourne les propriétés de la base de données KQL spécifiée.
Autorisations
L’appelant doit avoir visionneuse ou un rôle d’espace de travail supérieur.
Étendues déléguées requises
KQLDatabase.Read.All ou KQLDatabase.ReadWrite.All ou Item.Read.All ou Item.ReadWrite.All
Identités prises en charge par Microsoft Entra
Cette API prend en charge les identités Microsoft répertoriées dans cette section.
| Identité | Soutien |
|---|---|
| Utilisateur | Oui |
| principal de service et identités managées | Oui |
Interface
GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/kqlDatabases/{kqlDatabaseId}Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
kql
|
path | True |
string uuid |
ID de base de données KQL. |
|
workspace
|
path | True |
string uuid |
ID de l’espace de travail. |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
La demande s’est terminée avec succès. |
|
| Other Status Codes |
Codes d’erreur courants :
|
Exemples
Get a KQL database example
Exemple de requête
GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/kqlDatabases/5b218778-e7a5-4d73-8187-f10824047715
Exemple de réponse
{
"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"
}
}Définitions
| Nom | Description |
|---|---|
|
Error |
Objet de détails de ressource associé à l’erreur. |
|
Error |
Réponse d’erreur. |
|
Error |
Détails de la réponse d’erreur. |
|
Item |
Type de l’élément. Des types d’éléments supplémentaires peuvent être ajoutés au fil du temps. |
| KQLDatabase |
Objet de base de données KQL. |
|
KQLDatabase |
Propriétés de la base de données KQL. |
|
Kql |
Type de la base de données. |
ErrorRelatedResource
Objet de détails de ressource associé à l’erreur.
| Nom | Type | Description |
|---|---|---|
| resourceId |
string |
ID de ressource impliqué dans l’erreur. |
| resourceType |
string |
Type de la ressource impliquée dans l’erreur. |
ErrorResponse
Réponse d’erreur.
| Nom | Type | Description |
|---|---|---|
| errorCode |
string |
Identificateur spécifique qui fournit des informations sur une condition d’erreur, ce qui permet une communication standardisée entre notre service et ses utilisateurs. |
| message |
string |
Représentation lisible humaine de l’erreur. |
| moreDetails |
Liste des détails d’erreur supplémentaires. |
|
| relatedResource |
Détails de la ressource associée à l’erreur. |
|
| requestId |
string |
ID de la demande associée à l’erreur. |
ErrorResponseDetails
Détails de la réponse d’erreur.
| Nom | Type | Description |
|---|---|---|
| errorCode |
string |
Identificateur spécifique qui fournit des informations sur une condition d’erreur, ce qui permet une communication standardisée entre notre service et ses utilisateurs. |
| message |
string |
Représentation lisible humaine de l’erreur. |
| relatedResource |
Détails de la ressource associée à l’erreur. |
ItemType
Type de l’élément. Des types d’éléments supplémentaires peuvent être ajoutés au fil du temps.
| Valeur | Description |
|---|---|
| Dashboard |
Tableau de bord PowerBI. |
| DataPipeline |
Un pipeline de données. |
| Datamart |
Datamart PowerBI. |
| Environment |
Environnement. |
| Eventhouse |
Un eventhouse. |
| Eventstream |
Flux d’événements. |
| GraphQLApi |
API pour l’élément GraphQL. |
| KQLDashboard |
Tableau de bord KQL. |
| KQLDatabase |
Base de données KQL. |
| KQLQueryset |
Ensemble de requêtes KQL. |
| Lakehouse |
Un lac. |
| MLExperiment |
Une expérience de Machine Learning. |
| MLModel |
Modèle Machine Learning. |
| MirroredDatabase |
Une base de données mise en miroir. |
| MirroredWarehouse |
Un entrepôt mis en miroir. |
| MountedDataFactory |
Un MountedDataFactory. |
| Notebook |
Un bloc-notes. |
| PaginatedReport |
Rapport paginé PowerBI. |
| Reflex |
Un réflexe. |
| Report |
Rapport PowerBI. |
| SQLDatabase |
A SQLDatabase. |
| SQLEndpoint |
Point de terminaison SQL. |
| SemanticModel |
Modèle sémantique PowerBI. |
| SparkJobDefinition |
Définition d’un travail Spark. |
| Warehouse |
Un entrepôt. |
KQLDatabase
Objet de base de données KQL.
| Nom | Type | Description |
|---|---|---|
| description |
string |
Description de l’élément. |
| displayName |
string |
Nom complet de l’élément. |
| id |
string uuid |
ID d’élément. |
| properties |
Propriétés de la base de données KQL. |
|
| type |
Type d’élément. |
|
| workspaceId |
string uuid |
ID de l’espace de travail. |
KQLDatabaseProperties
Propriétés de la base de données KQL.
| Nom | Type | Description |
|---|---|---|
| databaseType |
Type de la base de données. |
|
| ingestionServiceUri |
string |
URI du service d’ingestion. |
| parentEventhouseItemId |
string |
ID d’eventhouse parent. |
| queryServiceUri |
string |
URI du service de requête. |
KqlDatabaseType
Type de la base de données.
| Valeur | Description |
|---|---|
| ReadWrite |
Autorise les opérations de lecture et d’écriture sur la base de données. |
| Shortcut |
Un raccourci est une référence incorporée qui autorise les opérations en lecture seule sur une base de données source. La source peut se trouver dans les mêmes locataires ou différents, soit dans un cluster Azure Data Explorer, soit dans un eventhouse Fabric. |