Items - Update KQL Database

Başvuru

Hizmet:: KQLDatabase

API Sürümü:: v1

Belirtilen KQL veritabanının özelliklerini güncelleştirir.

İ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

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

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
kqlDatabaseId	path	True	string uuid	KQL veritabanı kimliği.
workspaceId	path	True	string uuid	Çalışma alanı kimliği.

İstek Gövdesi

Name	Tür	Description
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.

Yanıtlar

Name	Tür	Description
200 OK	KQLDatabase	İstek başarıyla tamamlandı.
Other Status Codes	ErrorResponse	Yaygın hata kodları: ItemNotFound - İstenen öğe bulunamadı InvalidRequest - Geçersiz güncelleştirme isteği.

Name

Tür

Description

200 OK

KQLDatabase

İstek başarıyla tamamlandı.

Other Status Codes

ErrorResponse

Yaygın hata kodları:

ItemNotFound - İstenen öğe bulunamadı
InvalidRequest - Geçersiz güncelleştirme isteği.

Örnekler

Update a KQL database example

Örnek isteği

HTTP

PATCH https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/kqlDatabases/5b218778-e7a5-4d73-8187-f10824047715

{
  "displayName": "KQLDatabase_New_Name",
  "description": "A new description for KQL database."
}

Örnek yanıt

Durum kodu:: 200

{
  "displayName": "KQLDatabase_New_Name",
  "description": "A new description for KQL database.",
  "type": "KQLDatabase",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

Tanımlar

Name	Description
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.
KQLDatabaseProperties	KQL veritabanı özellikleri.
KqlDatabaseType	Veritabanının türü.
UpdateKQLDatabaseRequest	KQL veritabanı isteğini güncelleştirin.

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.

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.

UpdateKQLDatabaseRequest

Object

KQL veritabanı isteğini güncelleştirin.

Name	Tür	Description
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.

Aracılığıyla paylaş

Items - Update KQL Database

İzinler

Gerekli Temsilci Kapsamları

Microsoft Entra tarafından desteklenen kimlikler

Arayüz

URI Parametreleri

İstek Gövdesi

Yanıtlar

Örnekler

Update a KQL database example

Örnek isteği

Örnek yanıt

Tanımlar

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemType

KQLDatabase

KQLDatabaseProperties

KqlDatabaseType

UpdateKQLDatabaseRequest

Ek kaynaklar