Items - Update KQL Queryset
Aktualisiert die Eigenschaften des angegebenen KQL-Abfragesets.
Erlaubnisse
Der Aufrufer muss Lese- und Schreibberechtigungen für das KQL-Abfrageset besitzen.
Erforderliche delegierte Bereiche
KQLQueryset.ReadWrite.All oder Item.ReadWrite.All
Von Microsoft Entra unterstützte Identitäten
Diese API unterstützt die in diesem Abschnitt aufgeführten Microsoft Identitäten.
| Identität | Unterstützen |
|---|---|
| Benutzer | Ja |
| Dienstprinzipal und verwaltete Identitäten | Ja |
Schnittstelle
PATCH https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/kqlQuerysets/{kqlQuerysetId}URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
kql
|
path | True |
string (uuid) |
Die KQL-Abfrageset-ID. |
|
workspace
|
path | True |
string (uuid) |
Die Arbeitsbereichs-ID. |
Anforderungstext
| Name | Typ | Beschreibung |
|---|---|---|
| description |
string |
Die KQL-Abfragesetbeschreibung. Die maximale Länge beträgt 256 Zeichen. |
| displayName |
string |
Der Anzeigename des KQL-Abfragesets. Der Anzeigename muss den Benennungsregeln entsprechend dem Elementtyp entsprechen. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
Die Anforderung wurde erfolgreich abgeschlossen. |
|
| Other Status Codes |
Häufige Fehlercodes:
|
Beispiele
Update a KQL queryset example
Beispielanforderung
PATCH https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/kqlQuerysets/5b218778-e7a5-4d73-8187-f10824047715
{
"displayName": "KQLQueryset_New_Name",
"description": "A new description for KQL queryset."
}
Beispiel für eine Antwort
{
"displayName": "KQLQueryset_New_Name",
"description": "A new description for KQL queryset.",
"type": "KQLQueryset",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"id": "5b218778-e7a5-4d73-8187-f10824047715"
}Definitionen
| Name | Beschreibung |
|---|---|
|
Error |
Das Fehlerbezogene Ressourcendetails-Objekt. |
|
Error |
Die Fehlerantwort. |
|
Error |
Die Fehlerantwortdetails. |
|
Item |
Stellt ein Tag dar, das auf ein Element angewendet wird. |
|
Item |
Der Typ des Elements. Zusätzliche Elementtypen können im Laufe der Zeit hinzugefügt werden. |
| KQLQueryset |
Ein KQL-Abfragesetobjekt. |
|
Update |
Aktualisieren der KQL-Abfragemengeanforderung. |
ErrorRelatedResource
Das Fehlerbezogene Ressourcendetails-Objekt.
| Name | Typ | Beschreibung |
|---|---|---|
| resourceId |
string |
Die Ressourcen-ID, die an dem Fehler beteiligt ist. |
| resourceType |
string |
Der Typ der Ressource, die an dem Fehler beteiligt ist. |
ErrorResponse
Die Fehlerantwort.
| Name | Typ | Beschreibung |
|---|---|---|
| errorCode |
string |
Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht. |
| message |
string |
Eine lesbare Darstellung des Fehlers. |
| moreDetails |
Liste der zusätzlichen Fehlerdetails. |
|
| relatedResource |
Die fehlerbezogenen Ressourcendetails. |
|
| requestId |
string |
ID der Anforderung, die dem Fehler zugeordnet ist. |
ErrorResponseDetails
Die Fehlerantwortdetails.
| Name | Typ | Beschreibung |
|---|---|---|
| errorCode |
string |
Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht. |
| message |
string |
Eine lesbare Darstellung des Fehlers. |
| relatedResource |
Die fehlerbezogenen Ressourcendetails. |
ItemTag
Stellt ein Tag dar, das auf ein Element angewendet wird.
| Name | Typ | Beschreibung |
|---|---|---|
| displayName |
string |
Der Name des Tags. |
| id |
string (uuid) |
Die Tag-ID. |
ItemType
Der Typ des Elements. Zusätzliche Elementtypen können im Laufe der Zeit hinzugefügt werden.
| Wert | Beschreibung |
|---|---|
| Dashboard |
PowerBI-Dashboard. |
| Report |
PowerBI-Bericht. |
| SemanticModel |
PowerBI-Semantikmodell. |
| PaginatedReport |
PowerBI-Paginated-Bericht. |
| Datamart |
PowerBI datamart. |
| Lakehouse |
Ein Seehaus. |
| Eventhouse |
Ein Eventhouse. |
| Environment |
Eine Umgebung. |
| KQLDatabase |
Eine KQL-Datenbank. |
| KQLQueryset |
Ein KQL-Abfrageset. |
| KQLDashboard |
Ein KQL-Dashboard. |
| DataPipeline |
Eine Datenpipeline. |
| Notebook |
Ein Notizbuch. |
| SparkJobDefinition |
Eine Sparkauftragsdefinition. |
| MLExperiment |
Ein Machine Learning-Experiment. |
| MLModel |
Ein Machine Learning-Modell. |
| Warehouse |
Ein Lagerhaus. |
| Eventstream |
Ein Ereignisstream. |
| SQLEndpoint |
Ein SQL-Endpunkt. |
| MirroredWarehouse |
Ein gespiegeltes Lager. |
| MirroredDatabase |
Eine gespiegelte Datenbank. |
| Reflex |
Ein Reflex. |
| GraphQLApi |
Eine API für GraphQL-Element. |
| MountedDataFactory |
Eine MountedDataFactory. |
| SQLDatabase |
Eine SQLDatabase. |
| CopyJob |
Ein Kopierauftrag. |
| VariableLibrary |
Eine VariableLibrary. |
| Dataflow |
Ein Datenfluss. |
| ApacheAirflowJob |
Ein ApacheAirflowJob. |
| WarehouseSnapshot |
Eine Warehouse-Momentaufnahme. |
| DigitalTwinBuilder |
Ein DigitalTwinBuilder. |
| DigitalTwinBuilderFlow |
Ein Digital Twin Builder Flow. |
| MirroredAzureDatabricksCatalog |
Ein gespiegelter Azure Databricks-Katalog. |
| Map |
Eine Karte. |
| AnomalyDetector |
Anomaliedetektor. |
| UserDataFunction |
Eine Benutzerdatenfunktion. |
| GraphModel |
Ein GraphModel. |
| GraphQuerySet |
Ein Graph QuerySet. |
| SnowflakeDatabase |
Eine Snowflake-Datenbank zum Speichern von Iceberg-Tabellen, die aus dem Snowflake-Konto erstellt wurden. |
| OperationsAgent |
Ein OperationsAgent. |
| CosmosDBDatabase |
Eine Cosmos DB-Datenbank. |
| Ontology |
Eine Ontologie. |
| EventSchemaSet |
Ein EventSchemaSet. |
KQLQueryset
Ein KQL-Abfragesetobjekt.
| Name | Typ | Beschreibung |
|---|---|---|
| description |
string |
Die Elementbeschreibung. |
| displayName |
string |
Der Anzeigename des Elements. |
| folderId |
string (uuid) |
Die Ordner-ID. |
| id |
string (uuid) |
Die Element-ID. |
| tags |
Item |
Liste der angewendeten Tags. |
| type |
Der Elementtyp. |
|
| workspaceId |
string (uuid) |
Die Arbeitsbereichs-ID. |
UpdateKQLQuerysetRequest
Aktualisieren der KQL-Abfragemengeanforderung.
| Name | Typ | Beschreibung |
|---|---|---|
| description |
string |
Die KQL-Abfragesetbeschreibung. Die maximale Länge beträgt 256 Zeichen. |
| displayName |
string |
Der Anzeigename des KQL-Abfragesets. Der Anzeigename muss den Benennungsregeln entsprechend dem Elementtyp entsprechen. |