Items - Create Mirrored Azure Databricks Catalog

Hizmet:: MirroredAzureDatabricksCatalog

API Sürümü:: v1

Uyarı

Bu API önizleme aşamasındadır.

Belirtilen çalışma alanında yansıtılmış birAzureDatabricksCatalog oluşturur.
Bu API, uzun süre çalışan işlemleri (LRO)destekler.

İzinler

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

Gerekli Temsilci Kapsamları

MirroredAzureDatabricksCatalog.ReadWrite.All veya Item.ReadWrite.All

Microsoft Entra destekli kimlikler

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

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

Arayüz

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

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	MirroredAzureDatabricksCatalog görünen adı. Görünen ad, öğe türüne göre adlandırma kurallarına uymalıdır.
creationPayload		MirroredAzureDatabricksCatalogCreationPayload	MirroredAzureDatabricksCatalog oluşturma yükü.
definition		MirroredAzureDatabricksCatalogPublicDefinition	MirroredAzureDatabricksCatalog genel tanımı. `definition` veya `creationPayload` kullanın. İkisini de aynı anda kullanamazsınız.
description		string	MirroredAzureDatabricksCatalog açıklaması. Uzunluk üst sınırı 256 karakterdir.

Yanıtlar

Name	Tür	Description
201 Created	MirroredAzureDatabricksCatalog	Başarıyla oluşturuldu
202 Accepted		İstek kabul edildi, yansıtılmışAzureDatabricksCatalog 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.

Name

Tür

Description

201 Created

MirroredAzureDatabricksCatalog

Başarıyla oluşturuldu

202 Accepted

İstek kabul edildi, yansıtılmışAzureDatabricksCatalog 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 mirroredAzureDatabricksCatalog with creation payload example

Create an mirroredAzureDatabricksCatalog with definition example

Create a mirroredAzureDatabricksCatalog with creation payload example

Örnek isteği

HTTP

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

{
  "displayName": "MirroredAzureDatabricksCatalog_created_with_creationPayload",
  "description": "A MirroredAzureDatabricksCatalog created with creation payload.",
  "creationPayload": {
    "catalogName": "catalog_1",
    "databricksWorkspaceConnectionId": "c1128f28-d84f-417c-8234-0feb91e35f86",
    "mirroringMode": "Full",
    "storageConnectionId": "c1128f28-d84f-417c-8234-0feb91e35f87"
  }
}

Örnek yanıt

Durum kodu:: 201

{
  "displayName": "MirroredAzureDatabricksCatalog_created_with_creationPayload",
  "description": "A MirroredAzureDatabricksCatalog created with creation payload.",
  "type": "MirroredAzureDatabricksCatalog",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

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 an mirroredAzureDatabricksCatalog with definition example

Örnek isteği

HTTP

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

{
  "displayName": "MirroredAzureDatabricksCatalog_created_with_definition",
  "description": "A MirroredAzureDatabricksCatalog created with definition.",
  "definition": {
    "parts": [
      {
        "path": "mirroredAzureDatabricksCatalog.json",
        "payload": "eyAicHJvcGVydGllcy..WJsZSIgfSB9IH0gXSB9IH0",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

Örnek yanıt

Durum kodu:: 201

{
  "displayName": "MirroredAzureDatabricksCatalog_created_with_definition",
  "description": "A MirroredAzureDatabricksCatalog created with definition.",
  "type": "MirroredAzureDatabricksCatalog",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

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
AutoSync	Katalog için otomatik eşitlemeyi etkinleştirin veya devre dışı bırakın. Etkinleştirildiğinde, şemalar ve tablolar da dahil olmak üzere tüm meta veri değişiklikleri her 15 dakikada bir otomatik olarak eşitlenir. Devre dışı bırakıldığında, kullanıcıların meta verileri el ile yenilemesi gerekir. Bu ayar yalnızca güncelleştirme isteği sırasında değiştirilebilir. Zaman içinde ek `autoSync` türleri eklenebilir.
CreateMirroredAzureDatabricksCatalogRequest	MirroredAzureDatabricksCatalog istek yükü oluşturun.
ErrorInfo	Hata bilgileri.
ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.
ItemTag	Bir öğeye uygulanan etiketi temsil eder.
ItemType	Öğenin türü. Zaman içinde ek öğe türleri eklenebilir.
MirroredAzureDatabricksCatalog	MirroredAzureDatabricksCatalog öğesi.
MirroredAzureDatabricksCatalogCreationPayload	MirroredAzureDatabricksCatalog öğe yükü oluşturur.
MirroredAzureDatabricksCatalogProperties	MirroredAzureDatabricksCatalog özellikleri.
MirroredAzureDatabricksCatalogPublicDefinition	MirroredAzureDatabricksCatalog genel tanım nesnesi. MirroredAzureDatabricksCatalog tanımı genel tanımı oluşturma hakkında daha fazla bilgi için bu makaleye bakın.
MirroredAzureDatabricksCatalogPublicDefinitionPart	MirroredAzureDatabricksCatalog tanım bölümü nesnesi.
MirroringModes	Yansıtma modu. Zaman içinde ek mirroringMode eklenebilir.
MirrorStatus	Yansıtma durumu. Zaman içinde ek durum eklenebilir.
PayloadType	Tanım parçası yükünün türü. Zaman içinde ek yük türleri eklenebilir.
SqlEndpointProperties	SQL uç noktasının özelliklerini içeren bir nesne.
Status	Eşitleme durumu. Zaman içinde ek durum eklenebilir.
SyncDetails	MirroredAzureDatabricksCatalog yansıtma durumu.

AutoSync

Listeleme

Katalog için otomatik eşitlemeyi etkinleştirin veya devre dışı bırakın. Etkinleştirildiğinde, şemalar ve tablolar da dahil olmak üzere tüm meta veri değişiklikleri her 15 dakikada bir otomatik olarak eşitlenir. Devre dışı bırakıldığında, kullanıcıların meta verileri el ile yenilemesi gerekir. Bu ayar yalnızca güncelleştirme isteği sırasında değiştirilebilir. Zaman içinde ek autoSync türleri eklenebilir.

Değer	Description
Disabled	Otomatik eşitleme devre dışı bırakıldı.
Enabled	Otomatik eşitleme etkinleştirildi.

CreateMirroredAzureDatabricksCatalogRequest

Object

MirroredAzureDatabricksCatalog istek yükü oluşturun.

Name	Tür	Description
creationPayload	MirroredAzureDatabricksCatalogCreationPayload	MirroredAzureDatabricksCatalog oluşturma yükü.
definition	MirroredAzureDatabricksCatalogPublicDefinition	MirroredAzureDatabricksCatalog genel tanımı. `definition` veya `creationPayload` kullanın. İkisini de aynı anda kullanamazsınız.
description	string	MirroredAzureDatabricksCatalog açıklaması. Uzunluk üst sınırı 256 karakterdir.
displayName	string	MirroredAzureDatabricksCatalog görünen adı. Görünen ad, öğe türüne göre adlandırma kurallarına uymalıdır.

ErrorInfo

Object

Hata bilgileri.

Name	Tür	Description
errorCode	string	Hata kodu.
errorDetails	string	Hata ayrıntıları.
errorMessage	string	Hata iletisi.

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ı.

ItemTag

Object

Bir öğeye uygulanan etiketi temsil eder.

Name	Tür	Description
displayName	string	Etiketin adı.
id	string (uuid)	Etiket kimliği.

ItemType

Listeleme

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

Değer	Description
ApacheAirflowJob	An ApacheAirflowJob.
CopyJob	Kopyalama işi.
Dashboard	PowerBI panosu.
DataPipeline	Veri işlem hattı.
Dataflow	Veri akışı.
Datamart	PowerBI datamart.
DigitalTwinBuilder	A DigitalTwinBuilder.
DigitalTwinBuilderFlow	Dijital İkiz Oluşturucu Akışı.
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.
MirroredAzureDatabricksCatalog	Yansıtılmış azure databricks kataloğu.
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ı.
VariableLibrary	Bir VariableLibrary.
Warehouse	Bir depo.
WarehouseSnapshot	Ambar anlık görüntüsü.

MirroredAzureDatabricksCatalog

Object

MirroredAzureDatabricksCatalog öğesi.

Name	Tür	Description
description	string	Öğe açıklaması.
displayName	string	Öğenin görünen adı.
folderId	string (uuid)	Klasör kimliği.
id	string (uuid)	Öğe kimliği.
properties	MirroredAzureDatabricksCatalogProperties	MirroredAzureDatabricksCatalog özellikleri.
tags	ItemTag[]	Uygulanan etiketlerin listesi.
type	ItemType	Öğe türü.
workspaceId	string (uuid)	Çalışma alanı kimliği.

MirroredAzureDatabricksCatalogCreationPayload

Object

MirroredAzureDatabricksCatalog öğe yükü oluşturur.

Name	Tür	Description
catalogName	string	Azure databricks katalog adı.
databricksWorkspaceConnectionId	string (uuid)	Azure databricks çalışma alanı bağlantı kimliği.
mirroringMode	MirroringModes	Yansıtma modu.
storageConnectionId	string (uuid)	Depolama bağlantısı kimliği.

MirroredAzureDatabricksCatalogProperties

Object

MirroredAzureDatabricksCatalog özellikleri.

Name	Tür	Description
autoSync	AutoSync	Kataloğu otomatik olarak eşitleyin. Zaman içinde ek `autoSync` türleri eklenebilir.
catalogName	string	Azure databricks katalog adı.
databricksWorkspaceConnectionId	string (uuid)	Azure databricks çalışma alanı bağlantı kimliği.
mirrorStatus	MirrorStatus	MirroredAzureDatabricksCatalog eşitleme durumu.
mirroringMode	MirroringModes	Yansıtma modu. Zaman içinde ek mirroringMode eklenebilir.
oneLakeTablesPath	string	MirroredAzureDatabricksCatalog tables dizinine giden OneLake yolu.
sqlEndpointProperties	SqlEndpointProperties	SQL uç noktasının özelliklerini içeren bir nesne.
storageConnectionId	string (uuid)	Depolama bağlantısı kimliği.
syncDetails	SyncDetails	MirroredAzureDatabricksCatalog eşitleme durumu.

MirroredAzureDatabricksCatalogPublicDefinition

Object

MirroredAzureDatabricksCatalog genel tanım nesnesi. MirroredAzureDatabricksCatalog tanımı genel tanımı oluşturma hakkında daha fazla bilgi için bu makaleye bakın.

Name	Tür	Description
format	string	Öğe tanımının biçimi.
parts	MirroredAzureDatabricksCatalogPublicDefinitionPart[]	Tanım bölümlerinin listesi.

MirroredAzureDatabricksCatalogPublicDefinitionPart

Object

MirroredAzureDatabricksCatalog tanım bölümü nesnesi.

Name	Tür	Description
path	string	MirroredAzureDatabricksCatalog bölüm yolu.
payload	string	MirroredAzureDatabricksCatalog parça yükü.
payloadType	PayloadType	Yük türü.

MirroringModes

Listeleme

Yansıtma modu. Zaman içinde ek mirroringMode eklenebilir.

Değer	Description
Full	Özel olarak dışlanan şemalar ve tablolar dışında bir kataloğun içindeki her şeyi yansıt. Dışlama sağlanmazsa her şey varsayılan olarak eşitlenir.
Partial	Yalnızca seçili şemalar ve tablolar yansıtılır. Hiçbir şey varsayılan olarak eşitlenmez.

MirrorStatus

Listeleme

Yansıtma durumu. Zaman içinde ek durum eklenebilir.

Değer	Description
Mirrored	Kaynağındaki tüm şemaların ve tabloların MirroredAzureDatabricksCatalog öğesiyle tam olarak eşitlenmesini sağlayarak kataloğun tamamının başarıyla yansıtıldığını gösterir.
NotMirrored	Kataloğun henüz yansıtılmadığını gösterir. Açıkça yapılandırılmadığı sürece hiçbir şema veya tablo varsayılan olarak eşitlenmez.

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.

SqlEndpointProperties

Object

SQL uç noktasının özelliklerini içeren bir nesne.

Name	Tür	Description
connectionString	string	SQL uç noktası bağlantı dizesi.
id	string	SQL uç noktası kimliği.

Status

Listeleme

Eşitleme durumu. Zaman içinde ek durum eklenebilir.

Değer	Description
Failed	Yansıtma işlemi başarısız oldu.
InProgress	Yansıtma işlemi şu anda devam ediyor.
NotStarted	Katalog yansıtması henüz başlatılmadı
Success	Katalog başarıyla yansıtıldı.

SyncDetails

Object

MirroredAzureDatabricksCatalog yansıtma durumu.

Name	Tür	Description
errorInfo	ErrorInfo	Hata bilgileri.
lastSyncDateTime	string (date-time)	YYYY-AA-GGTHH:mm:ssZ biçimini kullanarak UTC'deki son eşitleme tarihi saati.
status	Status	Eşitleme durumu. Zaman içinde ek durum eklenebilir.

Aracılığıyla paylaş

Items - Create Mirrored Azure Databricks Catalog

İzinler

Gerekli Temsilci Kapsamları

Microsoft Entra destekli kimlikler

Arayüz

URI Parametreleri

İstek Gövdesi

Yanıtlar

Örnekler

Create a mirroredAzureDatabricksCatalog with creation payload example

Örnek isteği

Örnek yanıt

Create an mirroredAzureDatabricksCatalog with definition example

Örnek isteği

Örnek yanıt

Tanımlar

AutoSync

CreateMirroredAzureDatabricksCatalogRequest

ErrorInfo

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemTag

ItemType

MirroredAzureDatabricksCatalog

MirroredAzureDatabricksCatalogCreationPayload

MirroredAzureDatabricksCatalogProperties

MirroredAzureDatabricksCatalogPublicDefinition

MirroredAzureDatabricksCatalogPublicDefinitionPart

MirroringModes

MirrorStatus

PayloadType

SqlEndpointProperties

Status

SyncDetails