Items - List KQL Querysets

Szolgáltatás:

KQLQueryset

API-verzió:

v1

A megadott munkaterület KQL-lekérdezéskészleteinek listáját adja vissza.
Ez az API támogatja lapozási.

Engedélyek

A hívónak megtekintő vagy magasabb munkaterületi szerepkört kell tartalmaznia.

Kötelező delegált hatókörök

Workspace.Read.All vagy Workspace.ReadWrite.All

Microsoft Entra által támogatott identitások

Ez az API támogatja az ebben a szakaszban felsorolt Microsoft identitásokat.

Azonosság	Támogat
Felhasználó	Igen
szolgáltatásnév és felügyelt identitások	Igen

Interfész

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

Opcionális paraméterekkel:

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
workspaceId	path	True	string (uuid)	A munkaterület azonosítója.
continuationToken	query		string	Jogkivonat az eredmények következő oldalának lekéréséhez.

Válaszok

Name	Típus	Description
200 OK	KQLQuerysets	A kérés sikeresen befejeződött.
Other Status Codes	ErrorResponse	Gyakori hibakódok: InvalidItemType – Érvénytelen elemtípus

Példák

List KQL querysets in workspace example

Mintakérelem

HTTP

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

Mintaválasz

Állapotkód:

200

{
  "value": [
    {
      "id": "3546052c-ae64-4526-b1a8-52af7761426f",
      "displayName": "KQLQueryset_1",
      "description": "A KQL queryset description.",
      "type": "KQLQueryset",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    },
    {
      "id": "4c9adc22-ffb1-491f-baaa-9c9987745591",
      "displayName": "KQLQueryset_2",
      "description": "A KQL queryset description.",
      "type": "KQLQueryset",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    },
    {
      "id": "8b681594-894d-4adf-8ae8-aed415dd1de6",
      "displayName": "KQLQueryset_3",
      "description": "A KQL queryset description.",
      "type": "KQLQueryset",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    }
  ]
}

Definíciók

Name	Description
ErrorRelatedResource	A hibával kapcsolatos erőforrás-részletek objektum.
ErrorResponse	A hibaválasz.
ErrorResponseDetails	A hibaválasz részletei.
ItemTag	Egy elemre alkalmazott címkét jelöl.
ItemType	Az elem típusa. Idővel további elemtípusok is hozzáadhatók.
KQLQueryset	KQL-lekérdezéskészlet-objektum.
KQLQuerysets	KQL-lekérdezéskészletek listája.

ErrorRelatedResource

Objektum

A hibával kapcsolatos erőforrás-részletek objektum.

Name	Típus	Description
resourceId	string	A hibában érintett erőforrás-azonosító.
resourceType	string	A hibában érintett erőforrás típusa.

ErrorResponse

Objektum

A hibaválasz.

Name	Típus	Description
errorCode	string	Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message	string	A hiba emberi olvasható ábrázolása.
moreDetails	ErrorResponseDetails[]	További hibaadatok listája.
relatedResource	ErrorRelatedResource	A hibával kapcsolatos erőforrásadatok.
requestId	string	A hibához társított kérés azonosítója.

ErrorResponseDetails

Objektum

A hibaválasz részletei.

Name	Típus	Description
errorCode	string	Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message	string	A hiba emberi olvasható ábrázolása.
relatedResource	ErrorRelatedResource	A hibával kapcsolatos erőforrásadatok.

ItemTag

Objektum

Egy elemre alkalmazott címkét jelöl.

Name	Típus	Description
displayName	string	A címke neve.
id	string (uuid)	A címke azonosítója.

ItemType

Enumerálás

Az elem típusa. Idővel további elemtípusok is hozzáadhatók.

Érték	Description
CopyJob	Másolási feladat.
Dashboard	PowerBI-irányítópult.
DataPipeline	Egy adatfolyam.
Datamart	PowerBI datamart.
Environment	Egy környezet.
Eventhouse	Egy rendezvényház.
Eventstream	Eseménystream.
GraphQLApi	Api a GraphQL-elemhez.
KQLDashboard	KQL-irányítópult.
KQLDatabase	KQL-adatbázis.
KQLQueryset	KQL-lekérdezéskészlet.
Lakehouse	Egy tóház.
MLExperiment	Gépi tanulási kísérlet.
MLModel	Gépi tanulási modell.
MirroredDatabase	Tükrözött adatbázis.
MirroredWarehouse	Egy tükrözött raktár.
MountedDataFactory	A MountedDataFactory.
Notebook	Egy jegyzetfüzet.
PaginatedReport	Többoldalas PowerBI-jelentés.
Reflex	Egy reflex.
Report	PowerBI-jelentés.
SQLDatabase	A SQLDatabase.
SQLEndpoint	EGY SQL-végpont.
SemanticModel	PowerBI szemantikai modell.
SparkJobDefinition	Spark-feladat definíciója.
VariableLibrary	Egy VariableLibrary.
Warehouse	Egy raktár.

KQLQueryset

Objektum

KQL-lekérdezéskészlet-objektum.

Name	Típus	Description
description	string	Az elem leírása.
displayName	string	Az elem megjelenítendő neve.
folderId	string (uuid)	A mappa azonosítója.
id	string (uuid)	Az elem azonosítója.
tags	ItemTag[]	Az alkalmazott címkék listája.
type	ItemType	Az elem típusa.
workspaceId	string (uuid)	A munkaterület azonosítója.

KQLQuerysets

Objektum

KQL-lekérdezéskészletek listája.

Name	Típus	Description
continuationToken	string	A következő eredményhalmaz kötegének jogkivonata. Ha nincs több rekord, az törlődik a válaszból.
continuationUri	string	A következő eredményhalmaz köteg URI-ja. Ha nincs több rekord, az törlődik a válaszból.
value	KQLQueryset[]	KQL-lekérdezéskészletek listája.