Delen via

Items - Get KQL Database

  • Referentie
Service:
KQLDatabase
API-versie:
v1

Retourneert eigenschappen van de opgegeven KQL-database.

Machtigingen

De beller moet viewer hebben of een hogere werkruimterol.

Vereiste gedelegeerde bereiken

KQLDatabase.Read.All of KQLDatabase.ReadWrite.All of Item.Read.All of Item.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/{kqlDatabaseId}

URI-parameters

Name In Vereist Type Description
kqlDatabaseId
 path True

string

uuid

De KQL-database-id.
workspaceId
 path True

string

uuid

De werkruimte-id.

Antwoorden

Name Type Description
200 OK

KQLDatabase

De aanvraag is voltooid.
Other Status Codes

ErrorResponse

Veelvoorkomende foutcodes:

  • ItemNotFound : het aangevraagde item is niet gevonden.

Voorbeelden

Get a KQL database example

Voorbeeldaanvraag

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/kqlDatabases/5b218778-e7a5-4d73-8187-f10824047715

Voorbeeldrespons

Statuscode:
200 
{
  "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"
  }
}

Definities

Name Description
ErrorRelatedResource

Het foutgerelateerde resourcedetailsobject.
ErrorResponse

Het foutbericht.
ErrorResponseDetails

De details van het foutbericht.
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.
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.

ItemType

Inventarisatie

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

Waarde Description
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.
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.
id

string

uuid

De item-id.
properties

KQLDatabaseProperties

De eigenschappen van de KQL-database.
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.

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.