Bagikan melalui

Items - List KQL Databases

  • Referensi
Layanan:
KQLDatabase
Versi API:
v1

Mengembalikan daftar database KQL dari ruang kerja yang ditentukan.
API ini mendukung penomoran halaman.

Izin

Pemanggil harus memiliki peran penampil atau ruang kerja yang lebih tinggi.

Cakupan yang Didelegasikan yang Diperlukan

Workspace.Read.All atau Workspace.ReadWrite.All

Identitas yang didukung Microsoft Entra

API ini mendukung identitas Microsoft yang tercantum di bagian ini.

Identitas Dukung
Pengguna Ya
perwakilan Layanan dan identitas terkelola Ya

Antarmuka

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
workspaceId
 path True

string

uuid

ID ruang kerja.
continuationToken
 query

string

Token untuk mengambil halaman hasil berikutnya.

Respons

Nama Jenis Deskripsi
200 OK

KQLDatabases

Permintaan berhasil diselesaikan.
Other Status Codes

ErrorResponse

Kode kesalahan umum:

  • InvalidItemType - Tipe item tidak valid

Contoh

List KQL databases in workspace example

Permintaan sampel

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

Respon sampel

Kode status:
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"
      }
    }
  ]
}

Definisi

Nama Deskripsi
ErrorRelatedResource

Objek detail sumber daya terkait kesalahan.
ErrorResponse

Respons kesalahan.
ErrorResponseDetails

Detail respons kesalahan.
ItemType

Jenis item. Jenis item tambahan dapat ditambahkan dari waktu ke waktu.
KQLDatabase

Objek database KQL.
KQLDatabaseProperties

Properti database KQL.
KQLDatabases

Daftar database KQL.
KqlDatabaseType

Jenis database.

ErrorRelatedResource

Objek

Objek detail sumber daya terkait kesalahan.

Nama Jenis Deskripsi
resourceId

string

ID sumber daya yang terlibat dalam kesalahan.
resourceType

string

Jenis sumber daya yang terlibat dalam kesalahan.

ErrorResponse

Objek

Respons kesalahan.

Nama Jenis Deskripsi
errorCode

string

Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya.
message

string

Representasi kesalahan yang dapat dibaca manusia.
moreDetails

ErrorResponseDetails[]

Daftar detail kesalahan tambahan.
relatedResource

ErrorRelatedResource

Detail sumber daya terkait kesalahan.
requestId

string

ID permintaan yang terkait dengan kesalahan.

ErrorResponseDetails

Objek

Detail respons kesalahan.

Nama Jenis Deskripsi
errorCode

string

Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya.
message

string

Representasi kesalahan yang dapat dibaca manusia.
relatedResource

ErrorRelatedResource

Detail sumber daya terkait kesalahan.

ItemType

Enumeration

Jenis item. Jenis item tambahan dapat ditambahkan dari waktu ke waktu.

Nilai Deskripsi
Dashboard

Dasbor PowerBI.
DataPipeline

Alur data.
Datamart

Datamart PowerBI.
Environment

Lingkungan.
Eventhouse

Sebuah rumah acara.
Eventstream

Eventstream.
GraphQLApi

API untuk item GraphQL.
KQLDashboard

Dasbor KQL.
KQLDatabase

Database KQL.
KQLQueryset

Set kueri KQL.
Lakehouse

Sebuah lakehouse.
MLExperiment

Eksperimen pembelajaran mesin.
MLModel

Model pembelajaran mesin.
MirroredDatabase

Database cermin.
MirroredWarehouse

Sebuah gudang cermin.
MountedDataFactory

A MountedDataFactory.
Notebook

Buku catatan.
PaginatedReport

Laporan paginasi PowerBI.
Reflex

Sebuah Refleks.
Report

Laporan PowerBI.
SQLDatabase

Sebuah SQLDatabase.
SQLEndpoint

Titik akhir SQL.
SemanticModel

Model semantik PowerBI.
SparkJobDefinition

Definisi pekerjaan spark.
Warehouse

Sebuah gudang.

KQLDatabase

Objek

Objek database KQL.

Nama Jenis Deskripsi
description

string

Deskripsi item.
displayName

string

Nama tampilan item.
id

string

uuid

ID item.
properties

KQLDatabaseProperties

Properti database KQL.
type

ItemType

Jenis item.
workspaceId

string

uuid

ID ruang kerja.

KQLDatabaseProperties

Objek

Properti database KQL.

Nama Jenis Deskripsi
databaseType

KqlDatabaseType

Jenis database.
ingestionServiceUri

string

URI layanan penyerapan.
parentEventhouseItemId

string

ID eventhouse induk.
queryServiceUri

string

URI layanan kueri.

KQLDatabases

Objek

Daftar database KQL.

Nama Jenis Deskripsi
continuationToken

string

Token untuk batch tataan hasil berikutnya. Jika tidak ada rekaman lagi, rekaman akan dihapus dari respons.
continuationUri

string

URI dari batch tataan hasil berikutnya. Jika tidak ada rekaman lagi, rekaman akan dihapus dari respons.
value

KQLDatabase[]

Daftar database KQL.

KqlDatabaseType

Enumeration

Jenis database.

Nilai Deskripsi
ReadWrite

Memungkinkan operasi baca dan tulis pada database.
Shortcut

Pintasan adalah referensi tersemat yang memungkinkan operasi baca saja pada database sumber. Sumbernya dapat berada di penyewa yang sama atau berbeda, baik di kluster Azure Data Explorer atau Fabric Eventhouse.