Items - List KQL Databases

Service:

KQLDatabase

API-versie:

v1

Retourneert een lijst met KQL-databases uit de opgegeven werkruimte.
Deze API ondersteunt paginering.

Machtigingen

De beller moet viewer hebben of een hogere werkruimterol.

Vereiste gedelegeerde bereiken

Workspace.Read.All of Workspace.ReadWrite.All

Door Microsoft Entra ondersteunde identiteiten

Deze API ondersteunt de Microsoft -identiteiten vermeld in deze sectie.

Identiteit	Steunen
Gebruiker	Ja
service-principal en beheerde identiteiten	Ja

Interface

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/kqlDatabases

Met optionele parameters:

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/kqlDatabases?continuationToken={continuationToken}

URI-parameters

Name	In	Vereist	Type	Description
workspaceId	path	True	string (uuid)	De werkruimte-id.
continuationToken	query		string	Een token voor het ophalen van de volgende pagina met resultaten.

Antwoorden

Name	Type	Description
200 OK	KQLDatabases	De aanvraag is voltooid.
Other Status Codes	ErrorResponse	Veelvoorkomende foutcodes: InvalidItemType - Ongeldig itemtype

Voorbeelden

List KQL databases in workspace example

Voorbeeldaanvraag

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/kqlDatabases

Voorbeeldrespons

Statuscode:

200

{
  "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"
      }
    }
  ]
}

Definities

Name	Description
ErrorRelatedResource	Het foutgerelateerde resourcedetailsobject.
ErrorResponse	Het foutbericht.
ErrorResponseDetails	De details van het foutbericht.
ItemTag	Vertegenwoordigt een tag die is toegepast op een item.
ItemType	Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.
KQLDatabase	Een KQL-databaseobject.
KQLDatabaseProperties	De eigenschappen van de KQL-database.
KQLDatabases	Een lijst met KQL-databases.
KqlDatabaseType	Het type database.

ErrorRelatedResource

Object

Het foutgerelateerde resourcedetailsobject.

Name	Type	Description
resourceId	string	De resource-id die betrokken is bij de fout.
resourceType	string	Het type resource dat betrokken is bij de fout.

ErrorResponse

Object

Het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
moreDetails	ErrorResponseDetails[]	Lijst met aanvullende foutdetails.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.
requestId	string	Id van de aanvraag die is gekoppeld aan de fout.

ErrorResponseDetails

Object

De details van het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.

ItemTag

Object

Vertegenwoordigt een tag die is toegepast op een item.

Name	Type	Description
displayName	string	De naam van de tag.
id	string (uuid)	De tag-id.

ItemType

Inventarisatie

Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.

Waarde	Description
CopyJob	Een kopieertaak.
Dashboard	PowerBI-dashboard.
DataPipeline	Een gegevenspijplijn.
Datamart	PowerBI-datamart.
Environment	Een omgeving.
Eventhouse	Een eventhouse.
Eventstream	Een eventstream.
GraphQLApi	Een API voor GraphQL-item.
KQLDashboard	Een KQL-dashboard.
KQLDatabase	Een KQL-database.
KQLQueryset	Een KQL-queryset.
Lakehouse	Een lakehouse.
MLExperiment	Een machine learning-experiment.
MLModel	Een machine learning-model.
MirroredDatabase	Een gespiegelde database.
MirroredWarehouse	Een gespiegeld magazijn.
MountedDataFactory	Een MountedDataFactory.
Notebook	Een notitieblok.
PaginatedReport	Gepagineerd Power BI-rapport.
Reflex	Een reflex.
Report	PowerBI-rapport.
SQLDatabase	Een SQLDatabase.
SQLEndpoint	Een SQL-eindpunt.
SemanticModel	Semantisch Power BI-model.
SparkJobDefinition	Een Spark-taakdefinitie.
VariableLibrary	Een VariableLibrary.
Warehouse	Een magazijn.

KQLDatabase

Object

Een KQL-databaseobject.

Name	Type	Description
description	string	De beschrijving van het item.
displayName	string	De weergavenaam van het item.
folderId	string (uuid)	De map-id.
id	string (uuid)	De item-id.
properties	KQLDatabaseProperties	De eigenschappen van de KQL-database.
tags	ItemTag[]	Lijst met toegepaste tags.
type	ItemType	Het itemtype.
workspaceId	string (uuid)	De werkruimte-id.

KQLDatabaseProperties

Object

De eigenschappen van de KQL-database.

Name	Type	Description
databaseType	KqlDatabaseType	Het type database.
ingestionServiceUri	string	URI van opnameservice.
parentEventhouseItemId	string	Bovenliggende gebeurtenishouse-id.
queryServiceUri	string	Queryservice-URI.

KQLDatabases

Object

Een lijst met KQL-databases.

Name	Type	Description
continuationToken	string	Het token voor de volgende batch met resultatensets. Als er geen records meer zijn, wordt deze verwijderd uit het antwoord.
continuationUri	string	De URI van de volgende batch met resultatensets. Als er geen records meer zijn, wordt deze verwijderd uit het antwoord.
value	KQLDatabase[]	Een lijst met KQL-databases.

KqlDatabaseType

Inventarisatie

Het type database.

Waarde	Description
ReadWrite	Hiermee staat u lees- en schrijfbewerkingen voor de database toe.
Shortcut	Een snelkoppeling is een ingesloten verwijzing die alleen-lezenbewerkingen voor een brondatabase toestaat. De bron kan zich in dezelfde of verschillende tenants bevinden, hetzij in een Azure Data Explorer-cluster of een Fabric Eventhouse.