Aracılığıyla paylaş

Items - Create KQL Database

  • Başvuru
Hizmet:
KQLDatabase
API Sürümü:
v1

Belirtilen çalışma alanında bir KQL veritabanı oluşturur.
Bu API, uzun süre çalışan işlemleri (LRO)destekler.

İzinler

Çağıranın katkıda bulunan veya daha yüksek çalışma alanı rolü olmalıdır.

Gerekli Temsilci Kapsamları

KQLDatabase.ReadWrite.All veya Item.ReadWrite.All

Sınırlama

  • KQL veritabanı oluşturmak için çalışma alanının desteklenen bir Yapı kapasitesinde olması gerekir. Daha fazla bilgi için bkz. Microsoft Fabric lisans türleri.

Microsoft Entra tarafından desteklenen kimlikler

Bu API, bu bölümde listelenen Microsoft kimliklerini destekler.

Kimlik Destek
Kullanıcı Evet
Hizmet sorumlusu ve yönetilen kimlikler Evet

Arayüz

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

URI Parametreleri

Name İçinde Gerekli Tür Description
workspaceId
 path True

string

uuid

Çalışma alanı kimliği.

İstek Gövdesi

Name Gerekli Tür Description
displayName True

string

KQL veritabanı görünen adı. Veritabanı adı alfasayısal karakterler, alt çizgi, nokta ve kısa çizgi içerebilir. Özel karakterler desteklenmez.
creationPayload KQLDatabaseCreationPayload:

KQL veritabanı oluşturma yükü. definition veya creationPayloadkullanın. İkisini de aynı anda kullanamazsınız.
definition

KQLDatabaseDefinition

KQL veritabanı genel tanımı. creationPayload veya definitionkullanın. İkisini de aynı anda kullanamazsınız.
description

string

KQL veritabanı açıklaması. Uzunluk üst sınırı 256 karakterdir.

Yanıtlar

Name Tür Description
201 Created

KQLDatabase

Başarıyla oluşturuldu
202 Accepted

İstek kabul edildi, KQL veritabanı sağlama devam ediyor

Üst Bilgiler

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

ErrorResponse

Yaygın hata kodları:

  • InvalidItemType - Öğe türü geçersiz

  • ItemDisplayNameAlreadyInUse - Öğe görünen adı zaten kullanılıyor

  • BozukPayload - Sağlanan yük bozuk.

Örnekler

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

Örnek isteği

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

Örnek yanıt

Durum kodu:
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

Örnek isteği

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

Örnek yanıt

Durum kodu:
201 
{
  "displayName": "KQLDatabase_1",
  "description": "A KQL database description.",
  "type": "KQLDatabase",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047651"
}
Durum kodu:
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

Örnek isteği

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

Örnek yanıt

Durum kodu:
201 
{
  "displayName": "KQLDatabase_1",
  "description": "A KQL database description.",
  "type": "KQLDatabase",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047653"
}
Durum kodu:
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

Örnek isteği

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

Örnek yanıt

Durum kodu:
201 
{
  "displayName": "KQLDatabase_1",
  "description": "A KQL database description.",
  "type": "KQLDatabase",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047654"
}
Durum kodu:
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

Örnek isteği

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

Örnek yanıt

Durum kodu:
201 
{
  "displayName": "KQLDatabase_1",
  "description": "A KQL database description.",
  "type": "KQLDatabase",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047652"
}
Durum kodu:
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

Tanımlar

Name Description
CreateKQLDatabaseRequest

KQL veritabanı istek yükü oluşturun.
ErrorRelatedResource

Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse

Hata yanıtı.
ErrorResponseDetails

Hata yanıtı ayrıntıları.
ItemType

Öğenin türü. Zaman içinde ek öğe türleri eklenebilir.
KQLDatabase

KQL veritabanı nesnesi.
KQLDatabaseDefinition

KQL veritabanı genel tanım nesnesi.
KQLDatabaseDefinitionPart

KQL veritabanı tanımı parça nesnesi.
KQLDatabaseProperties

KQL veritabanı özellikleri.
KqlDatabaseType

Veritabanının türü.
PayloadType

Tanım parçası yükünün türü. Zaman içinde ek yük türleri eklenebilir.
ReadWriteDatabaseCreationPayload

ReadWrite KQL veritabanı öğesi oluşturma yükü
ShortcutDatabaseCreationPayload

Kısayol KQL veritabanı öğesi oluşturma yükü

CreateKQLDatabaseRequest

Object

KQL veritabanı istek yükü oluşturun.

Name Tür Description
creationPayload KQLDatabaseCreationPayload:

KQL veritabanı oluşturma yükü. definition veya creationPayloadkullanın. İkisini de aynı anda kullanamazsınız.
definition

KQLDatabaseDefinition

KQL veritabanı genel tanımı. creationPayload veya definitionkullanın. İkisini de aynı anda kullanamazsınız.
description

string

KQL veritabanı açıklaması. Uzunluk üst sınırı 256 karakterdir.
displayName

string

KQL veritabanı görünen adı. Veritabanı adı alfasayısal karakterler, alt çizgi, nokta ve kısa çizgi içerebilir. Özel karakterler desteklenmez.

ErrorRelatedResource

Object

Hatayla ilgili kaynak ayrıntıları nesnesi.

Name Tür Description
resourceId

string

Hataya dahil olan kaynak kimliği.
resourceType

string

Hataya dahil olan kaynağın türü.

ErrorResponse

Object

Hata yanıtı.

Name Tür Description
errorCode

string

Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message

string

Hatanın okunabilir bir gösterimi.
moreDetails

ErrorResponseDetails[]

Ek hata ayrıntılarının listesi.
relatedResource

ErrorRelatedResource

Hatayla ilgili kaynak ayrıntıları.
requestId

string

Hatayla ilişkili isteğin kimliği.

ErrorResponseDetails

Object

Hata yanıtı ayrıntıları.

Name Tür Description
errorCode

string

Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message

string

Hatanın okunabilir bir gösterimi.
relatedResource

ErrorRelatedResource

Hatayla ilgili kaynak ayrıntıları.

ItemType

Listeleme

Öğenin türü. Zaman içinde ek öğe türleri eklenebilir.

Değer Description
Dashboard

PowerBI panosu.
DataPipeline

Veri işlem hattı.
Datamart

PowerBI datamart.
Environment

Bir ortam.
Eventhouse

Bir olay evi.
Eventstream

Bir olay akışı.
GraphQLApi

GraphQL öğesi için bir API.
KQLDashboard

KQL panosu.
KQLDatabase

KQL veritabanı.
KQLQueryset

KQL sorgu kümesi.
Lakehouse

Göl evi.
MLExperiment

Makine öğrenmesi denemesi.
MLModel

Makine öğrenmesi modeli.
MirroredDatabase

Yansıtılmış veritabanı.
MirroredWarehouse

Aynalı bir depo.
MountedDataFactory

Bir MountedDataFactory.
Notebook

Bir not defteri.
PaginatedReport

PowerBI sayfalandırılmış raporu.
Reflex

Bir refleks.
Report

PowerBI raporu.
SQLDatabase

A SQLDatabase.
SQLEndpoint

Bir SQL uç noktası.
SemanticModel

PowerBI anlam modeli.
SparkJobDefinition

Spark iş tanımı.
Warehouse

Bir depo.

KQLDatabase

Object

KQL veritabanı nesnesi.

Name Tür Description
description

string

Öğe açıklaması.
displayName

string

Öğenin görünen adı.
id

string

uuid

Öğe kimliği.
properties

KQLDatabaseProperties

KQL veritabanı özellikleri.
type

ItemType

Öğe türü.
workspaceId

string

uuid

Çalışma alanı kimliği.

KQLDatabaseDefinition

Object

KQL veritabanı genel tanım nesnesi.

Name Tür Description
format

string

Öğe tanımının biçimi.
parts

KQLDatabaseDefinitionPart[]

Tanım bölümlerinin listesi.

KQLDatabaseDefinitionPart

Object

KQL veritabanı tanımı parça nesnesi.

Name Tür Description
path

string

KQL veritabanı parça yolu.
payload

string

KQL veritabanı parça yükü.
payloadType

PayloadType

Yük türü.

KQLDatabaseProperties

Object

KQL veritabanı özellikleri.

Name Tür Description
databaseType

KqlDatabaseType

Veritabanının türü.
ingestionServiceUri

string

Alma hizmeti URI'si.
parentEventhouseItemId

string

Üst olay evi kimliği.
queryServiceUri

string

Sorgu hizmeti URI'si.

KqlDatabaseType

Listeleme

Veritabanının türü.

Değer Description
ReadWrite

Veritabanında okuma ve yazma işlemlerine izin verir.
Shortcut

Kısayol, kaynak veritabanında salt okunur işlemlere izin veren ekli başvurudur. Kaynak, Azure Veri Gezgini kümesinde veya Fabric Eventhouse'da aynı veya farklı kiracılarda olabilir.

PayloadType

Listeleme

Tanım parçası yükünün türü. Zaman içinde ek yük türleri eklenebilir.

Değer Description
InlineBase64

Satır içi Temel 64.

ReadWriteDatabaseCreationPayload

Object

ReadWrite KQL veritabanı öğesi oluşturma yükü

Name Tür Description
databaseType string:

ReadWrite

KQL veritabanının türü
parentEventhouseItemId

string

uuid

Üst olay evi öğe kimliği.

ShortcutDatabaseCreationPayload

Object

Kısayol KQL veritabanı öğesi oluşturma yükü

Name Tür Description
databaseType string:

Shortcut

KQL veritabanının türü
invitationToken

string

Kaynak veritabanını takip etmek için davet belirteci
parentEventhouseItemId

string

uuid

Üst olay evi öğe kimliği.
sourceClusterUri

string

Kaynak Eventhouse veya Azure Veri Gezgini kümesinin URI'si
sourceDatabaseName

string

Kaynak Eventhouse veya Azure Veri Gezgini kümesinde izleyebileceğiniz veritabanının adı.