แชร์ผ่าน

Items - Create KQL Database

บริการ:
KQLDatabase
เวอร์ชัน API:
v1

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

สิทธิ์

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

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

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

ขีด จำกัด

  • ในการสร้างฐานข้อมูล KQL พื้นที่ทํางานจะต้องอยู่ในความจุ Fabric ที่ได้รับการสนับสนุน สําหรับข้อมูลเพิ่มเติม ดูที่: สิทธิ์การใช้งาน Microsoft Fabric

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

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

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

อิน เทอร์ เฟซ

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

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

ชื่อ ใน จำเป็น พิมพ์ คำอธิบาย
workspaceId
 path True

string (uuid)

ID พื้นที่ทํางาน

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

ชื่อ จำเป็น พิมพ์ คำอธิบาย
displayName True

string

ชื่อที่แสดงของฐานข้อมูล KQL ชื่อฐานข้อมูลสามารถมีอักขระพยัญชนะผสมตัวเลข ขีดล่าง จุด และเครื่องหมายยัติภังค์ ไม่รองรับอักขระพิเศษ
creationPayload KQLDatabaseCreationPayload:

ส่วนข้อมูลการสร้างฐานข้อมูล KQL ใช้ definition หรือ creationPayload คุณไม่สามารถใช้ทั้งสองอย่างในเวลาเดียวกัน
definition

KQLDatabaseDefinition

ฐานข้อมูล KQL คําจํากัดความสาธารณะ ใช้ creationPayload หรือ definition คุณไม่สามารถใช้ทั้งสองอย่างในเวลาเดียวกัน
description

string

คําอธิบายฐานข้อมูล KQL ความยาวสูงสุดคือ 256 อักขระ
folderId

string (uuid)

ID โฟลเดอร์ ถ้าไม่ได้ระบุหรือเป็น null ฐานข้อมูล KQL จะถูกสร้างขึ้นด้วยพื้นที่ทํางานเป็นโฟลเดอร์

การตอบสนอง

ชื่อ พิมพ์ คำอธิบาย
201 Created

KQLDatabase

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

คําขอที่ยอมรับ อยู่ระหว่างการเตรียมใช้งานฐานข้อมูล KQL

ส่วนหัว

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

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

  • InvalidItemType - ชนิดรายการไม่ถูกต้อง

  • ItemDisplayNameAlreadyInUse - ชื่อที่แสดงรายการถูกใช้แล้ว

  • CorruptedPayload - ส่วนข้อมูลที่ให้มาเสียหาย

  • WorkspaceItemsLimitExceeded - เกินขีดจํากัดของรายการพื้นที่ทํางาน

ตัวอย่าง

Create a ReadWrite KQL database example
Create a ReadWrite KQL database with definition example
Create a Shortcut KQL database to source Azure Data Explorer cluster example
Create a Shortcut KQL database to source Azure Data Explorer cluster with invitation token example
Create a Shortcut KQL database to source KQL database example

Create a ReadWrite KQL database example

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

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

{
  "displayName": "KQLDatabase_1",
  "description": "A KQL database description.",
  "creationPayload": {
    "databaseType": "ReadWrite",
    "parentEventhouseItemId": "5b218778-e7a5-4d73-8187-f10824047836"
  }
}

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

รหัสสถานะ:
202 
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Create a ReadWrite KQL database with definition example

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

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

{
  "displayName": "KQLDatabase_1",
  "description": "A KQL database description.",
  "definition": {
    "parts": [
      {
        "path": "DatabaseProperties.json",
        "payload": "ewogICJkYXRhYmFzZVR5cGUiOiAiUmVhZFdyaXRlIiwKICAicGFyZW50RXZlbnRob3VzZUl0ZW1JZCI6ICI1YjIxODc3OC1lN2E1LTRkNzMtODE4Ny1mMTA4MjQwNDc4MzYiLAogICJvbmVMYWtlQ2FjaGluZ1BlcmlvZCI6ICJQMzY1MDBEIiwKICAib25lTGFrZVN0YW5kYXJkU3RvcmFnZVBlcmlvZCI6ICJQMzY1MDBEIgp9",
        "payloadType": "InlineBase64"
      },
      {
        "path": "DatabaseSchema.kql",
        "payload": "Ly8gS1FMIHNjcmlwdAovLyBVc2UgbWFuYWdlbWVudCBjb21tYW5kcyBpbiB0aGlzIHNjcmlwdCB0byBjb25maWd1cmUgeW91ciBkYXRhYmFzZSBpdGVtcywgc3VjaCBhcyB0YWJsZXMsIGZ1bmN0aW9ucywgbWF0ZXJpYWxpemVkIHZpZXdzLCBhbmQgbW9yZS4KCi5jcmVhdGUtbWVyZ2UgdGFibGUgTXlMb2dzIChMZXZlbDpzdHJpbmcsIFRpbWVzdGFtcDpkYXRldGltZSwgVXNlcklkOnN0cmluZywgVHJhY2VJZDpzdHJpbmcsIE1lc3NhZ2U6c3RyaW5nLCBQcm9jZXNzSWQ6aW50KQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

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

รหัสสถานะ:
201 
{
  "displayName": "KQLDatabase_1",
  "description": "A KQL database description.",
  "type": "KQLDatabase",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047651"
}
รหัสสถานะ:
202 
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Create a Shortcut KQL database to source Azure Data Explorer cluster example

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

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

{
  "displayName": "KQLDatabase_1",
  "description": "A KQL database description.",
  "creationPayload": {
    "databaseType": "Shortcut",
    "parentEventhouseItemId": "5b218778-e7a5-4d73-8187-f10824047836",
    "sourceClusterUri": "https://adxcluster.westus.kusto.windows.net",
    "sourceDatabaseName": "MyDatabase"
  }
}

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

รหัสสถานะ:
201 
{
  "displayName": "KQLDatabase_1",
  "description": "A KQL database description.",
  "type": "KQLDatabase",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047653"
}
รหัสสถานะ:
202 
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Create a Shortcut KQL database to source Azure Data Explorer cluster with invitation token example

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

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

{
  "displayName": "KQLDatabase_1",
  "description": "A KQL database description.",
  "creationPayload": {
    "databaseType": "Shortcut",
    "parentEventhouseItemId": "5b218778-e7a5-4d73-8187-f10824047836",
    "invitationToken": "eyJ0eXAiOiJKVInvitationToken"
  }
}

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

รหัสสถานะ:
201 
{
  "displayName": "KQLDatabase_1",
  "description": "A KQL database description.",
  "type": "KQLDatabase",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047654"
}
รหัสสถานะ:
202 
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Create a Shortcut KQL database to source KQL database example

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

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

{
  "displayName": "KQLDatabase_1",
  "description": "A KQL database description.",
  "creationPayload": {
    "databaseType": "Shortcut",
    "parentEventhouseItemId": "5b218778-e7a5-4d73-8187-f10824047836",
    "sourceDatabaseName": "ac542109-abd1-4ee3-aec5-86282c01ee24"
  }
}

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

รหัสสถานะ:
201 
{
  "displayName": "KQLDatabase_1",
  "description": "A KQL database description.",
  "type": "KQLDatabase",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047652"
}
รหัสสถานะ:
202 
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

คำจำกัดความ

ชื่อ คำอธิบาย
CreateKQLDatabaseRequest

สร้างส่วนข้อมูลคําขอฐานข้อมูล KQL
ErrorRelatedResource

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

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

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

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

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

วัตถุฐานข้อมูล KQL
KQLDatabaseDefinition

วัตถุนิยามสาธารณะของฐานข้อมูล KQL
KQLDatabaseDefinitionPart

ออบเจ็กต์ส่วนของข้อกําหนดฐานข้อมูล KQL
KQLDatabaseProperties

คุณสมบัติฐานข้อมูล KQL
KqlDatabaseType

ชนิดของฐานข้อมูล
PayloadType

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

สร้างรายการฐานข้อมูล ReadWrite KQL
ShortcutDatabaseCreationPayload

ทางลัดการสร้างรายการฐานข้อมูล KQL เพย์โหลด

CreateKQLDatabaseRequest

วัตถุ

สร้างส่วนข้อมูลคําขอฐานข้อมูล KQL

ชื่อ พิมพ์ คำอธิบาย
creationPayload KQLDatabaseCreationPayload:

ส่วนข้อมูลการสร้างฐานข้อมูล KQL ใช้ definition หรือ creationPayload คุณไม่สามารถใช้ทั้งสองอย่างในเวลาเดียวกัน
definition

KQLDatabaseDefinition

ฐานข้อมูล KQL คําจํากัดความสาธารณะ ใช้ creationPayload หรือ definition คุณไม่สามารถใช้ทั้งสองอย่างในเวลาเดียวกัน
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

KQLDatabase

วัตถุ

วัตถุฐานข้อมูล KQL

ชื่อ พิมพ์ คำอธิบาย
description

string

คําอธิบายสินค้า
displayName

string

ชื่อที่แสดงของรายการ
folderId

string (uuid)

ID โฟลเดอร์
id

string (uuid)

รหัสสินค้า
properties

KQLDatabaseProperties

คุณสมบัติฐานข้อมูล KQL
tags

ItemTag[]

รายการของแท็กที่ใช้
type

ItemType

ชนิดหน่วยข้อมูล
workspaceId

string (uuid)

ID พื้นที่ทํางาน

KQLDatabaseDefinition

วัตถุ

วัตถุนิยามสาธารณะของฐานข้อมูล KQL

ชื่อ พิมพ์ คำอธิบาย
format

string

รูปแบบของข้อกําหนดหน่วยข้อมูล
parts

KQLDatabaseDefinitionPart[]

รายการของส่วนข้อกําหนด

KQLDatabaseDefinitionPart

วัตถุ

ออบเจ็กต์ส่วนของข้อกําหนดฐานข้อมูล KQL

ชื่อ พิมพ์ คำอธิบาย
path

string

เส้นทางส่วนของฐานข้อมูล KQL
payload

string

เพย์โหลดส่วนของฐานข้อมูล KQL
payloadType

PayloadType

ชนิดของส่วนข้อมูล

KQLDatabaseProperties

วัตถุ

คุณสมบัติฐานข้อมูล KQL

ชื่อ พิมพ์ คำอธิบาย
databaseType

KqlDatabaseType

ชนิดของฐานข้อมูล
ingestionServiceUri

string

URI บริการการนําเข้า
parentEventhouseItemId

string

ID อีเวนต์เฮ้าส์หลัก
queryServiceUri

string

URI ของบริการคิวรี

KqlDatabaseType

การแจงนับ

ชนิดของฐานข้อมูล

ค่า คำอธิบาย
ReadWrite

อนุญาตให้อ่านและเขียนการดําเนินการบนฐานข้อมูล
Shortcut

ทางลัดคือการอ้างอิงแบบฝังตัวที่อนุญาตให้ดําเนินการแบบอ่านอย่างเดียวในฐานข้อมูลต้นทาง แหล่งข้อมูลสามารถอยู่ในผู้เช่าเดียวกัน หรืออื่น ๆ ในคลัสเตอร์ Azure Data Explorer หรือ Fabric Eventhouse

PayloadType

การแจงนับ

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

ค่า คำอธิบาย
InlineBase64

ฐานแบบอินไลน์ 64

ReadWriteDatabaseCreationPayload

วัตถุ

สร้างรายการฐานข้อมูล ReadWrite KQL

ชื่อ พิมพ์ คำอธิบาย
databaseType string:

ReadWrite

ประเภทของฐานข้อมูล KQL
parentEventhouseItemId

string (uuid)

ID รายการอีเวนต์เฮ้าส์หลัก

ShortcutDatabaseCreationPayload

วัตถุ

ทางลัดการสร้างรายการฐานข้อมูล KQL เพย์โหลด

ชื่อ พิมพ์ คำอธิบาย
databaseType string:

Shortcut

ประเภทของฐานข้อมูล KQL
invitationToken

string

โทเค็นการเชิญเพื่อติดตามฐานข้อมูลต้นทาง
parentEventhouseItemId

string (uuid)

ID รายการอีเวนต์เฮ้าส์หลัก
sourceClusterUri

string

URI ของคลัสเตอร์ Eventhouse ต้นทางหรือ Azure Data Explorer
sourceDatabaseName

string

ชื่อของฐานข้อมูลที่จะทําตามในคลัสเตอร์ Eventhouse หรือ Azure Data Explorer ต้นทาง