Items - Create KQL Database

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

สิทธิ์

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

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

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

ขีด จำกัด

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

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

API นี้สนับสนุน Microsoft identitiesที่ระบุในส่วนนี้

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

อิน เทอร์ เฟซ

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 จะถูกสร้างขึ้นด้วยพื้นที่ทํางานเป็นโฟลเดอร์

sensitivityLabelSettings

SensitivityLabelSettings

การตั้งค่าป้ายชื่อระดับความลับสําหรับฐานข้อมูล KQL

การตอบสนอง

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

KQLDatabase

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

202 Accepted

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

ส่วนหัว

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
429 Too Many Requests

ErrorResponse

เกินขีดจํากัดอัตราการบริการ เซิร์ฟเวอร์จะส่งกลับ Retry-After ส่วนหัวที่ระบุ ภายในไม่กี่วินาที ระยะเวลาที่ไคลเอ็นต์ต้องรอก่อนที่จะส่งคําขอเพิ่มเติม

ส่วนหัว

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

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

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

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

{
  "displayName": "KQLDatabase_1",
  "description": "A KQL database description.",
  "type": "KQLDatabase",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047651",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}
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"
  }
}

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

{
  "displayName": "KQLDatabase_1",
  "description": "A KQL database description.",
  "type": "KQLDatabase",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047653",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}
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"
  }
}

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

{
  "displayName": "KQLDatabase_1",
  "description": "A KQL database description.",
  "type": "KQLDatabase",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047654",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}
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"
  }
}

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

{
  "displayName": "KQLDatabase_1",
  "description": "A KQL database description.",
  "type": "KQLDatabase",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047652",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}
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

EntireTenantPrincipal

แสดงองค์ประกอบหลักของผู้เช่า

ErrorRelatedResource

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

ErrorResponse

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

ErrorResponseDetails

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

GroupDetails

รายละเอียดเฉพาะของกลุ่ม ใช้ได้เมื่อชนิดหลัก Group

GroupPrincipal

แสดงกลุ่มความปลอดภัย

GroupType

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

ItemTag

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

ItemType

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

KQLDatabase

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

KQLDatabaseDefinition

วัตถุนิยามสาธารณะของฐานข้อมูล KQL โปรดดู บทความนี้ สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับโครงสร้างของข้อกําหนดของฐานข้อมูล KQL

KQLDatabaseDefinitionPart

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

KQLDatabaseProperties

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

KqlDatabaseType

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

PayloadType

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

PrincipalType

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

ReadWriteDatabaseCreationPayload

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

SensitivityLabel

แสดงป้ายชื่อระดับความลับที่ใช้กับรายการ

SensitivityLabelApplyStrategy

กลยุทธ์สําหรับการใช้ป้ายชื่อระดับความลับ ค่าเริ่มต้นคือ ApplyOrFail คุณสามารถเพิ่มชนิดเพิ่มเติมเมื่อเวลาผ่านไป

SensitivityLabelSettings

การตั้งค่าป้ายชื่อระดับความลับ

ServicePrincipalDetails

รายละเอียดเฉพาะของบริการหลัก ใช้ได้เมื่อชนิดหลัก ServicePrincipal

ServicePrincipalPrincipal

แสดง Microsoft Entra บริการหลัก

ServicePrincipalProfileDetails

รายละเอียดโปรไฟล์โครงร่างสําคัญของบริการ ใช้ได้เมื่อชนิดหลัก ServicePrincipalProfile

ServicePrincipalProfilePrincipal

แสดงโปรไฟล์บริการหลัก

ShortcutDatabaseCreationPayload

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

UserDetails

รายละเอียดเฉพาะของผู้ใช้หลัก ใช้ได้เมื่อชนิดหลัก User

UserPrincipal

แสดง Microsoft Entra หลักของผู้ใช้

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 จะถูกสร้างขึ้นด้วยพื้นที่ทํางานเป็นโฟลเดอร์

sensitivityLabelSettings

SensitivityLabelSettings

การตั้งค่าป้ายชื่อระดับความลับสําหรับฐานข้อมูล KQL

EntireTenantPrincipal

แสดงองค์ประกอบหลักของผู้เช่า

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

string

ชื่อที่แสดงขององค์ประกอบหลัก

id

string (uuid)

ID ของโครงร่างสําคัญ

type string:

EntireTenant

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

ErrorRelatedResource

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

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

string

ID ทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

resourceType

string

ชนิดของทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponse

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

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

string

ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้

isRetriable

boolean

เมื่อเป็นจริง สามารถลองคําขอใหม่ได้ ใช้ส่วนหัวการตอบสนอง Retry-After เพื่อกําหนดความล่าช้า ถ้ามี

message

string

การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้

moreDetails

ErrorResponseDetails[]

รายการรายละเอียดข้อผิดพลาดเพิ่มเติม

relatedResource

ErrorRelatedResource

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

requestId

string (uuid)

รหัสของคําขอที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponseDetails

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

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

string

ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้

message

string

การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้

relatedResource

ErrorRelatedResource

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

GroupDetails

รายละเอียดเฉพาะของกลุ่ม ใช้ได้เมื่อชนิดหลัก Group

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

GroupType

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

GroupPrincipal

แสดงกลุ่มความปลอดภัย

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

string

ชื่อที่แสดงขององค์ประกอบหลัก

groupDetails

GroupDetails

รายละเอียดเฉพาะของกลุ่ม ใช้ได้เมื่อชนิดหลัก Group

id

string (uuid)

ID ของโครงร่างสําคัญ

type string:

Group

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

GroupType

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

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

ไม่รู้จักชนิดกลุ่มหลัก

SecurityGroup

หลักคือกลุ่มความปลอดภัย

DistributionList

หลักคือรายการการแจกจ่าย

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

DataAgent

DataAgent

MirroredCatalog

มิเรอร์ดคาตาล็อก

AppBackend

AppBackend

OrgApp

แอปองค์กร

OrgAppAudience

ผู้ชมแอปองค์กร

DataBuildToolJob

DataBuildToolJob

AzureDatabricksStorage

รายการพื้นที่จัดเก็บข้อมูลที่สํารองข้อมูลโดย OneLake สําหรับ Azure Databricks

Plan

แผนน่ะ

KQLDatabase

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

ชื่อ พิมพ์ คำอธิบาย
defaultIdentity Principal:

ข้อมูลประจําตัวเริ่มต้นของรายการ

description

string

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

displayName

string

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

folderId

string (uuid)

ID โฟลเดอร์

id

string (uuid)

รหัสสินค้า

properties

KQLDatabaseProperties

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

sensitivityLabel

SensitivityLabel

ป้ายชื่อระดับความลับของหน่วยข้อมูล

tags

ItemTag[]

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

type

ItemType

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

workspaceId

string (uuid)

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

KQLDatabaseDefinition

วัตถุนิยามสาธารณะของฐานข้อมูล KQL โปรดดู บทความนี้ สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับโครงสร้างของข้อกําหนดของฐานข้อมูล KQL

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

string

รูปแบบของข้อกําหนดของฐานข้อมูล KQL

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

PayloadType

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

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

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

PrincipalType

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

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

หลักเป็น Microsoft Entra หลักของผู้ใช้

ServicePrincipal

หลักเป็น Microsoft Entra บริการหลัก

Group

หลักคือกลุ่มความปลอดภัย

ServicePrincipalProfile

หลักคือ โปรไฟล์โครงร่างสําคัญของบริการ

EntireTenant

หลักแสดงผู้ใช้ที่เป็นผู้เช่าทั้งหมด

ReadWriteDatabaseCreationPayload

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

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

ReadWrite

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

parentEventhouseItemId

string (uuid)

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

SensitivityLabel

แสดงป้ายชื่อระดับความลับที่ใช้กับรายการ

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

string (uuid)

รหัสป้ายชื่อระดับความลับ

SensitivityLabelApplyStrategy

กลยุทธ์สําหรับการใช้ป้ายชื่อระดับความลับ ค่าเริ่มต้นคือ ApplyOrFail คุณสามารถเพิ่มชนิดเพิ่มเติมเมื่อเวลาผ่านไป

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

ใช้ป้ายชื่อระดับความลับหรือล้มเหลวของการดําเนินการถ้าไม่สามารถนําไปใช้ได้

Ignore

ละเว้นป้ายชื่อระดับความลับหากไม่สามารถใช้และดําเนินการต่อด้วยการดําเนินการโดยไม่ต้องใช้ป้ายชื่อ

SensitivityLabelSettings

การตั้งค่าป้ายชื่อระดับความลับ

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

string (uuid)

รหัสป้ายชื่อระดับความลับ

sensitivityLabelApplyStrategy

SensitivityLabelApplyStrategy

กลยุทธ์สําหรับการใช้ป้ายชื่อระดับความลับ

ServicePrincipalDetails

รายละเอียดเฉพาะของบริการหลัก ใช้ได้เมื่อชนิดหลัก ServicePrincipal

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

string (uuid)

AppId Microsoft Entra ของโครงร่างสําคัญของบริการ

ServicePrincipalPrincipal

แสดง Microsoft Entra บริการหลัก

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

string

ชื่อที่แสดงขององค์ประกอบหลัก

id

string (uuid)

ID ของโครงร่างสําคัญ

servicePrincipalDetails

ServicePrincipalDetails

รายละเอียดเฉพาะของบริการหลัก ใช้ได้เมื่อชนิดหลัก ServicePrincipal

type string:

ServicePrincipal

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

ServicePrincipalProfileDetails

รายละเอียดโปรไฟล์โครงร่างสําคัญของบริการ ใช้ได้เมื่อชนิดหลัก ServicePrincipalProfile

ชื่อ พิมพ์ คำอธิบาย
parentPrincipal Principal:

โครงร่างสําคัญของโปรไฟล์บริการหลัก

ServicePrincipalProfilePrincipal

แสดงโปรไฟล์บริการหลัก

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

string

ชื่อที่แสดงขององค์ประกอบหลัก

id

string (uuid)

ID ของโครงร่างสําคัญ

servicePrincipalProfileDetails

ServicePrincipalProfileDetails

รายละเอียดโปรไฟล์โครงร่างสําคัญของบริการ ใช้ได้เมื่อชนิดหลัก ServicePrincipalProfile

type string:

ServicePrincipalProfile

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

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

UserDetails

รายละเอียดเฉพาะของผู้ใช้หลัก ใช้ได้เมื่อชนิดหลัก User

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

string

ชื่อหลักของผู้ใช้

UserPrincipal

แสดง Microsoft Entra หลักของผู้ใช้

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

string

ชื่อที่แสดงขององค์ประกอบหลัก

id

string (uuid)

ID ของโครงร่างสําคัญ

type string:

User

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

userDetails

UserDetails

รายละเอียดเฉพาะของผู้ใช้หลัก ใช้ได้เมื่อชนิดหลัก User