Sdílet prostřednictvím

Items - Create KQL Queryset

  • Reference
Služba:
KQLQueryset
Verze rozhraní API:
v1

Vytvoří v zadaném pracovním prostoru sadu dotazů KQL.
Pokud chcete vytvořit sadu dotazů KQL s definicí, projděte si článek definice sady dotazů KQL.

Dovolení

Volající musí mít roli přispěvatele nebo vyšší.

Požadované delegovaná rozsahy

KQLQueryset.ReadWrite.All nebo Item.ReadWrite.All

Podporované identity Microsoft Entra

Toto rozhraní API podporuje identity Microsoft uvedené v této části.

Identita Podpora
Uživatel Ano
instančního objektu a spravované identity Ano

Rozhraní

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
workspaceId
 path True

string

uuid

ID pracovního prostoru.

Text požadavku

Name Vyžadováno Typ Description
displayName True

string

Zobrazovaný název sady dotazů KQL. Zobrazovaný název musí odpovídat pravidlům pojmenování podle typu položky.
definition

KQLQuerysetDefinition

Veřejná definice sady dotazů KQL.
description

string

Popis sady dotazů KQL. Maximální délka je 256 znaků.

Odpovědi

Name Typ Description
201 Created

KQLQueryset

Úspěšně vytvořeno
Other Status Codes

ErrorResponse

Běžné kódy chyb:

  • InvalidItemType – Typ položky je neplatný.

  • ItemDisplayNameAlreadyInUse – Zobrazovaný název položky je již použit.

  • Poškozená částPayload – zadanou datovou část je poškozena.

Příklady

Create a KQL queryset example
Create a KQL queryset with definition example

Create a KQL queryset example

Ukázkový požadavek

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

{
  "displayName": "KQLQueryset_1",
  "description": "A KQL queryset description"
}

Ukázková odpověď

Stavový kód:
201 
{
  "displayName": "KQLQueryset_1",
  "description": "A KQL queryset description",
  "type": "KQLQueryset",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

Create a KQL queryset with definition example

Ukázkový požadavek

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

{
  "displayName": "KQLQueryset_1",
  "description": "A KQL queryset description",
  "definition": {
    "format": null,
    "parts": [
      {
        "path": "RealTimeQueryset.json",
        "payload": "ewogICAgInF1ZXJ5c2V0IjogewogICAgICAgICJ2ZXJzaW9uIjogIjEuMC4wIiwKICAgICAgICAiZGF0YVNvdXJjZXMiOiBbewogICAgICAgICAgICAgICAgImlkIjogImMyNDM0YmY4LTI1YmItNGFhMC04NzQ2LWRiNDcwNTMzYWRhZiIsCiAgICAgICAgICAgICAgICAiY2x1c3RlclVyaSI6ICJodHRwczovL2hlbHAua3VzdG8ud2luZG93cy5uZXQvIiwKICAgICAgICAgICAgICAgICJ0eXBlIjogIkF6dXJlRGF0YUV4cGxvcmVyIiwKICAgICAgICAgICAgICAgICJkYXRhYmFzZU5hbWUiOiAiU2FtcGxlcyIKICAgICAgICAgICAgfQogICAgICAgIF0sCiAgICAgICAgInRhYnMiOiBbewogICAgICAgICAgICAgICAgImlkIjogImNjZDdiOTBjLTUxZmUtNDI5Zi1hODUzLTM4NWIwMmJkNzRjOSIsCiAgICAgICAgICAgICAgICAiY29udGVudCI6ICJTdG9ybUV2ZW50c1xcXFxufCBjb3VudCIsCiAgICAgICAgICAgICAgICAidGl0bGUiOiAiVGFiMU5hbWUiLAogICAgICAgICAgICAgICAgImRhdGFTb3VyY2VJZCI6ICJjMjQzNGJmOC0yNWJiLTRhYTAtODc0Ni1kYjQ3MDUzM2FkYWYiCiAgICAgICAgICAgIH0KICAgICAgICBdCiAgICB9Cn0=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

Ukázková odpověď

Stavový kód:
201 
{
  "displayName": "KQLQueryset_1",
  "description": "A KQL queryset description",
  "type": "KQLQueryset",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

Definice

Name Description
CreateKQLQuerysetRequest

Vytvořte datovou část žádosti o sadu dotazů KQL.
ErrorRelatedResource

Chyba související s objektem podrobností o prostředku.
ErrorResponse

Odpověď na chybu.
ErrorResponseDetails

Podrobnosti o odpovědi na chybu.
ItemType

Typ položky. V průběhu času je možné přidat další typy položek.
KQLQueryset

Objekt sady dotazů KQL.
KQLQuerysetDefinition

Objekt veřejné definice sady dotazů KQL
KQLQuerysetDefinitionPart

Objekt části definice sady dotazů KQL
PayloadType

Typ datové části definice. V průběhu času je možné přidat další typy datových částí.

CreateKQLQuerysetRequest

Objekt

Vytvořte datovou část žádosti o sadu dotazů KQL.

Name Typ Description
definition

KQLQuerysetDefinition

Veřejná definice sady dotazů KQL.
description

string

Popis sady dotazů KQL. Maximální délka je 256 znaků.
displayName

string

Zobrazovaný název sady dotazů KQL. Zobrazovaný název musí odpovídat pravidlům pojmenování podle typu položky.

ErrorRelatedResource

Objekt

Chyba související s objektem podrobností o prostředku.

Name Typ Description
resourceId

string

ID prostředku, které je součástí chyby.
resourceType

string

Typ prostředku, který je součástí chyby.

ErrorResponse

Objekt

Odpověď na chybu.

Name Typ Description
errorCode

string

Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message

string

Lidské čitelné vyjádření chyby.
moreDetails

ErrorResponseDetails[]

Seznam dalších podrobností o chybě
relatedResource

ErrorRelatedResource

Podrobnosti o prostředku souvisejícím s chybou
requestId

string

ID požadavku přidruženého k chybě.

ErrorResponseDetails

Objekt

Podrobnosti o odpovědi na chybu.

Name Typ Description
errorCode

string

Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message

string

Lidské čitelné vyjádření chyby.
relatedResource

ErrorRelatedResource

Podrobnosti o prostředku souvisejícím s chybou

ItemType

Výčet

Typ položky. V průběhu času je možné přidat další typy položek.

Hodnota Description
Dashboard

Řídicí panel PowerBI
DataPipeline

Datový kanál.
Datamart

Datový diagram PowerBI
Environment

Prostředí.
Eventhouse

Eventhouse.
Eventstream

Eventstream.
GraphQLApi

Rozhraní API pro položku GraphQL
KQLDashboard

Řídicí panel KQL.
KQLDatabase

Databáze KQL.
KQLQueryset

Sada dotazů KQL.
Lakehouse

Jezero.
MLExperiment

Experiment strojového učení.
MLModel

Model strojového učení.
MirroredDatabase

Zrcadlené databáze.
MirroredWarehouse

Zrcadlený sklad.
MountedDataFactory

A MountedDataFactory.
Notebook

Poznámkový blok.
PaginatedReport

Stránkovaná sestava PowerBI
Reflex

A Reflex.
Report

Sestava PowerBI
SQLDatabase

Databáze SQLDatabase.
SQLEndpoint

Koncový bod SQL.
SemanticModel

Sémantický model PowerBI
SparkJobDefinition

Definice úlohy Sparku.
Warehouse

Sklad.

KQLQueryset

Objekt

Objekt sady dotazů KQL.

Name Typ Description
description

string

Popis položky.
displayName

string

Zobrazovaný název položky.
id

string

uuid

ID položky.
type

ItemType

Typ položky.
workspaceId

string

uuid

ID pracovního prostoru.

KQLQuerysetDefinition

Objekt

Objekt veřejné definice sady dotazů KQL

Name Typ Description
format

string

Formát definice položky.
parts

KQLQuerysetDefinitionPart[]

Seznam částí definice.

KQLQuerysetDefinitionPart

Objekt

Objekt části definice sady dotazů KQL

Name Typ Description
path

string

Cesta části sady dotazů KQL.
payload

string

Datová část sady dotazů KQL.
payloadType

PayloadType

Typ datové části.

PayloadType

Výčet

Typ datové části definice. V průběhu času je možné přidat další typy datových částí.

Hodnota Description
InlineBase64

Vložená základna 64.