Items - Create KQL Queryset

บริการ:: KQLQueryset

เวอร์ชัน API:: v1

สร้างชุดคิวรี KQL ในพื้นที่ทํางานที่ระบุ
API นี้สนับสนุน การดําเนินการที่ใช้เวลานาน (LRO)

เมื่อต้องการสร้างชุดคิวรี KQL ที่มีข้อกําหนด ให้ดูบทความ ข้อกําหนดชุดคิวรี KQL

สิทธิ์

ผู้เรียกต้องมีบทบาทพื้นที่ทํางานผู้สนับสนุน

จําเป็นต้องมีขอบเขตที่ได้รับมอบสิทธิ์

KQLQueryset.ReadWrite.All หรือ Item.ReadWrite.All

ข้อมูลประจําตัวที่สนับสนุนของ Microsoft Entra

API นี้สนับสนุนข้อมูลประจําตัวของ Microsoft แสดงรายการในส่วนนี้

เอกลักษณ์	สนับสนุน
ผู้ใช้	ใช่
บริการหลักและข้อมูลประจําตัว ที่มีการจัดการ	ใช่

อิน เทอร์ เฟซ

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

พารามิเตอร์ URI

ชื่อ	ใน	จำเป็น	พิมพ์	คำอธิบาย
workspaceId	path	True	string (uuid)	ID พื้นที่ทํางาน

เนื้อความของคำขอ

ชื่อ	จำเป็น	พิมพ์	คำอธิบาย
displayName	True	string	ชื่อที่แสดงของชุดคิวรี KQL ชื่อที่แสดงต้องเป็นไปตามกฎการตั้งชื่อตามชนิดหน่วยข้อมูล
definition		KQLQuerysetDefinition	ข้อกําหนดสาธารณะของชุดคิวรี KQL
description		string	คําอธิบายของชุดคิวรี KQL ความยาวสูงสุดคือ 256 อักขระ
folderId		string (uuid)	ID โฟลเดอร์ ถ้าไม่ได้ระบุหรือเป็น null ชุดคิวรี KQL จะถูกสร้างขึ้นด้วยพื้นที่ทํางานเป็นโฟลเดอร์ของชุดคิวรีนั้น

การตอบสนอง

ชื่อ	พิมพ์	คำอธิบาย
201 Created	KQLQueryset	สร้างเสร็จเรียบร้อยแล้ว
202 Accepted		คําขอที่ยอมรับ การสร้างชุดคิวรี KQL กําลังอยู่ระหว่างดําเนินการ ส่วนหัว Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	รหัสข้อผิดพลาดทั่วไป: InvalidItemType - ชนิดรายการไม่ถูกต้อง ItemDisplayNameAlreadyInUse - ชื่อที่ใช้แสดงรายการถูกใช้แล้ว CorruptedPayload - ส่วนข้อมูลที่ให้มาเสียหาย WorkspaceItemsLimitExceeded - เกินขีดจํากัดของรายการพื้นที่ทํางาน

ชื่อ

พิมพ์

คำอธิบาย

201 Created

KQLQueryset

สร้างเสร็จเรียบร้อยแล้ว

202 Accepted

คําขอที่ยอมรับ การสร้างชุดคิวรี KQL กําลังอยู่ระหว่างดําเนินการ

ส่วนหัว

Location: string
x-ms-operation-id: string
Retry-After: integer

Other Status Codes

ErrorResponse

รหัสข้อผิดพลาดทั่วไป:

InvalidItemType - ชนิดรายการไม่ถูกต้อง
ItemDisplayNameAlreadyInUse - ชื่อที่ใช้แสดงรายการถูกใช้แล้ว
CorruptedPayload - ส่วนข้อมูลที่ให้มาเสียหาย
WorkspaceItemsLimitExceeded - เกินขีดจํากัดของรายการพื้นที่ทํางาน

ตัวอย่าง

Create a KQL queryset example

Create a KQL queryset with definition example

Create a KQL queryset example

คำขอตัวอย่าง

HTTP

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

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

คำตอบตัวอย่าง

รหัสสถานะ:: 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

คำขอตัวอย่าง

HTTP

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

คำตอบตัวอย่าง

รหัสสถานะ:: 201

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

คำจำกัดความ

ชื่อ	คำอธิบาย
CreateKQLQuerysetRequest	สร้างส่วนข้อมูลคําขอของชุดคิวรี KQL
ErrorRelatedResource	ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
ErrorResponse	การตอบสนองข้อผิดพลาด
ErrorResponseDetails	รายละเอียดการตอบสนองข้อผิดพลาด
ItemTag	แสดงแท็กที่ใช้กับรายการ
ItemType	ชนิดของสินค้า คุณสามารถเพิ่มชนิดหน่วยข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป
KQLQueryset	วัตถุชุดคิวรี KQL
KQLQuerysetDefinition	วัตถุนิยามสาธารณะของชุดคิวรี KQL
KQLQuerysetDefinitionPart	ออบเจ็กต์ส่วนของข้อกําหนดชุดคิวรี KQL
PayloadType	ชนิดของส่วนข้อกําหนดส่วนข้อมูล อาจมีการเพิ่มชนิดของส่วนข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป

CreateKQLQuerysetRequest

วัตถุ

สร้างส่วนข้อมูลคําขอของชุดคิวรี KQL

ชื่อ	พิมพ์	คำอธิบาย
definition	KQLQuerysetDefinition	ข้อกําหนดสาธารณะของชุดคิวรี KQL
description	string	คําอธิบายของชุดคิวรี KQL ความยาวสูงสุดคือ 256 อักขระ
displayName	string	ชื่อที่แสดงของชุดคิวรี KQL ชื่อที่แสดงต้องเป็นไปตามกฎการตั้งชื่อตามชนิดหน่วยข้อมูล
folderId	string (uuid)	ID โฟลเดอร์ ถ้าไม่ได้ระบุหรือเป็น null ชุดคิวรี KQL จะถูกสร้างขึ้นด้วยพื้นที่ทํางานเป็นโฟลเดอร์ของชุดคิวรีนั้น

ErrorRelatedResource

วัตถุ

ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ชื่อ	พิมพ์	คำอธิบาย
resourceId	string	ID ทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
resourceType	string	ชนิดของทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponse

วัตถุ

การตอบสนองข้อผิดพลาด

ชื่อ	พิมพ์	คำอธิบาย
errorCode	string	ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message	string	การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
moreDetails	ErrorResponseDetails[]	รายการรายละเอียดข้อผิดพลาดเพิ่มเติม
relatedResource	ErrorRelatedResource	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
requestId	string	รหัสของคําขอที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponseDetails

วัตถุ

รายละเอียดการตอบสนองข้อผิดพลาด

ชื่อ	พิมพ์	คำอธิบาย
errorCode	string	ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message	string	การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
relatedResource	ErrorRelatedResource	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ItemTag

วัตถุ

แสดงแท็กที่ใช้กับรายการ

ชื่อ	พิมพ์	คำอธิบาย
displayName	string	ชื่อของแท็ก
id	string (uuid)	ID แท็ก

ItemType

การแจงนับ

ชนิดของสินค้า คุณสามารถเพิ่มชนิดหน่วยข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
Dashboard	แดชบอร์ด PowerBI
Report	รายงาน PowerBI
SemanticModel	แบบจําลองความหมายของ PowerBI
PaginatedReport	รายงานที่มีการแบ่งหน้าของ PowerBI
Datamart	Datamart ของ PowerBI
Lakehouse	เลคเฮ้าส์
Eventhouse	อาคารจัดงาน
Environment	สภาพแวดล้อม
KQLDatabase	ฐานข้อมูล KQL
KQLQueryset	ชุดคิวรี KQL
KQLDashboard	แดชบอร์ด KQL
DataPipeline	ไปป์ไลน์ข้อมูล
Notebook	โน๊ตบุ๊ค
SparkJobDefinition	ข้อกําหนดงานแบบประกายไฟ
MLExperiment	การทดลองการเรียนรู้ของเครื่อง
MLModel	แบบจําลองการเรียนรู้ของเครื่อง
Warehouse	คลังสินค้า
Eventstream	เหตุการณ์กระแสข้อมูล
SQLEndpoint	จุดสิ้นสุด SQL
MirroredWarehouse	คลังสินค้าที่มิเรอร์
MirroredDatabase	ฐานข้อมูลที่มิเรอร์
Reflex	รีเฟล็กซ์
GraphQLApi	API สําหรับรายการ GraphQL
MountedDataFactory	เมาท์ DataFactory
SQLDatabase	SQLDatabase
CopyJob	งานคัดลอก
VariableLibrary	VariableLibrary
Dataflow	กระแสข้อมูล
ApacheAirflowJob	ApacheAirflowJob
WarehouseSnapshot	สแนปช็อตของคลังสินค้า
DigitalTwinBuilder	DigitalTwinBuilder
DigitalTwinBuilderFlow	โฟลว์ Digital Twin Builder
MirroredAzureDatabricksCatalog	แค็ตตาล็อก azure databricks ที่มิเรอร์
Map	แผนที่.
AnomalyDetector	การตรวจหาความผิดปกติ
UserDataFunction	ฟังก์ชันข้อมูลผู้ใช้
GraphModel	GraphModel
GraphQuerySet	ชุดคิวรีกราฟ
SnowflakeDatabase	ฐานข้อมูล Snowflake เพื่อจัดเก็บตาราง Iceberg ที่สร้างขึ้นจากบัญชี Snowflake
OperationsAgent	OperationsAgent
CosmosDBDatabase	ฐานข้อมูล Cosmos DB
Ontology	โทโพโลยี
EventSchemaSet	EventSchemaSet

KQLQueryset

วัตถุ

วัตถุชุดคิวรี KQL

ชื่อ	พิมพ์	คำอธิบาย
description	string	คําอธิบายสินค้า
displayName	string	ชื่อที่แสดงของรายการ
folderId	string (uuid)	ID โฟลเดอร์
id	string (uuid)	รหัสสินค้า
tags	ItemTag[]	รายการของแท็กที่ใช้
type	ItemType	ชนิดหน่วยข้อมูล
workspaceId	string (uuid)	ID พื้นที่ทํางาน

KQLQuerysetDefinition

วัตถุ

วัตถุนิยามสาธารณะของชุดคิวรี KQL

ชื่อ	พิมพ์	คำอธิบาย
format	string	รูปแบบของข้อกําหนดหน่วยข้อมูล
parts	KQLQuerysetDefinitionPart[]	รายการของส่วนข้อกําหนด

KQLQuerysetDefinitionPart

วัตถุ

ออบเจ็กต์ส่วนของข้อกําหนดชุดคิวรี KQL

ชื่อ	พิมพ์	คำอธิบาย
path	string	เส้นทางส่วนของชุดคิวรี KQL
payload	string	ส่วนข้อมูลของชุดคิวรี KQL
payloadType	PayloadType	ชนิดของส่วนข้อมูล

PayloadType

การแจงนับ

ชนิดของส่วนข้อกําหนดส่วนข้อมูล อาจมีการเพิ่มชนิดของส่วนข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
InlineBase64	ฐานแบบอินไลน์ 64

แชร์ผ่าน

Items - Create KQL Queryset

สิทธิ์

จําเป็นต้องมีขอบเขตที่ได้รับมอบสิทธิ์

ข้อมูลประจําตัวที่สนับสนุนของ Microsoft Entra

อิน เทอร์ เฟซ

พารามิเตอร์ URI

เนื้อความของคำขอ

การตอบสนอง

ตัวอย่าง

Create a KQL queryset example

คำขอตัวอย่าง

คำตอบตัวอย่าง

Create a KQL queryset with definition example

คำขอตัวอย่าง

คำตอบตัวอย่าง

คำจำกัดความ

CreateKQLQuerysetRequest

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemTag

ItemType

KQLQueryset

KQLQuerysetDefinition

KQLQuerysetDefinitionPart

PayloadType