Items - Create Mirrored Database

Služba:: MirroredDatabase

Verze rozhraní API:: v1

Vytvoří zrcadlenou databázi v zadaném pracovním prostoru.
Toto rozhraní API nepodporuje vytváření zrcadlené databáze bez definice. Pokud chcete vytvořit zrcadlenou databázi s definicí, přečtěte si definici zrcadlené databáze článku.

Dovolení

Volající musí mít roli pracovního prostoru přispěvatele .

Požadované delegovaná rozsahy

MirroredDatabase.ReadWrite.All nebo Item.ReadWrite.All

Podporované identity Microsoft Entra

Toto rozhraní API podporuje identity Microsoft uvedené v této části.

Identita	Podpora
Uživatel	Ano
instančního objektu a spravované identity	Ano

Rozhraní

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
workspaceId	path	True	string (uuid)	ID pracovního prostoru.

Text požadavku

Name	Vyžadováno	Typ	Description
definition	True	MirroredDatabaseDefinition	Veřejná definice zrcadlené databáze.
displayName	True	string	Zobrazovaný název zrcadlené databáze. Zobrazovaný název musí odpovídat pravidlům pojmenování podle typu položky.
description		string	Popis zrcadlené databáze. Maximální délka je 256 znaků.
folderId		string (uuid)	ID složky. Pokud není zadána nebo null, zrcadlené databáze se vytvoří s pracovním prostorem jako její složkou.

Odpovědi

Name	Typ	Description
201 Created	MirroredDatabase	Úspěšně vytvořeno
Other Status Codes	ErrorResponse	Běžné kódy chyb: InvalidItemType – Typ položky je neplatný. ItemDisplayNameAlreadyInUse – Zobrazovaný název položky je již použit. Poškozená částPayload – zadanou datovou část je poškozena. WorkspaceItemsLimitExceededed – Došlo k překročení limitu položek pracovního prostoru.

Name

Typ

Description

201 Created

MirroredDatabase

Úspěšně vytvořeno

Other Status Codes

ErrorResponse

Běžné kódy chyb:

InvalidItemType – Typ položky je neplatný.
ItemDisplayNameAlreadyInUse – Zobrazovaný název položky je již použit.
Poškozená částPayload – zadanou datovou část je poškozena.
WorkspaceItemsLimitExceededed – Došlo k překročení limitu položek pracovního prostoru.

Příklady

Create a mirrored database with public definition example

Ukázkový požadavek

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/mirroredDatabases

{
  "displayName": "Mirrored database 1",
  "description": "A mirrored database description",
  "definition": {
    "parts": [
      {
        "path": "mirroring.json",
        "payload": "eyAicHJvcGVydGllcy..WJsZSIgfSB9IH0gXSB9IH0",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

Ukázková odpověď

Stavový kód:: 201

{
  "displayName": "Mirrored database 1",
  "description": "A mirrored database description",
  "type": "MirroredDatabase",
  "workspaceId": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
  "id": "b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2"
}

Definice

Name	Description
CreateMirroredDatabaseRequest	Vytvořte datovou část požadavku na zrcadlenou databázi.
ErrorRelatedResource	Chyba související s objektem podrobností o prostředku.
ErrorResponse	Odpověď na chybu.
ErrorResponseDetails	Podrobnosti o odpovědi na chybu.
ItemTag	Představuje značku použitou u položky.
ItemType	Typ položky. V průběhu času je možné přidat další typy položek.
MirroredDatabase	Zrcadlená položka databáze.
MirroredDatabaseDefinition	Zrcadlený objekt veřejné definice databáze.
MirroredDatabaseDefinitionPart	Zrcadlený objekt části definice databáze.
MirroredDatabaseProperties	Vlastnosti zrcadlené databáze.
PayloadType	Typ datové části definice. V průběhu času je možné přidat další typy datových částí.
SqlEndpointProperties	Objekt obsahující vlastnosti koncového bodu SQL.
SqlEndpointProvisioningStatus	Typ stavu zřizování koncového bodu SQL. V průběhu času je možné přidat další typy `SqlEndpointProvisioningStatus`.

CreateMirroredDatabaseRequest

Objekt

Vytvořte datovou část požadavku na zrcadlenou databázi.

Name	Typ	Description
definition	MirroredDatabaseDefinition	Veřejná definice zrcadlené databáze.
description	string	Popis zrcadlené databáze. Maximální délka je 256 znaků.
displayName	string	Zobrazovaný název zrcadlené databáze. Zobrazovaný název musí odpovídat pravidlům pojmenování podle typu položky.
folderId	string (uuid)	ID složky. Pokud není zadána nebo null, zrcadlené databáze se vytvoří s pracovním prostorem jako její složkou.

ErrorRelatedResource

Objekt

Chyba související s objektem podrobností o prostředku.

Name	Typ	Description
resourceId	string	ID prostředku, které je součástí chyby.
resourceType	string	Typ prostředku, který je součástí chyby.

ErrorResponse

Objekt

Odpověď na chybu.

Name	Typ	Description
errorCode	string	Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message	string	Lidské čitelné vyjádření chyby.
moreDetails	ErrorResponseDetails[]	Seznam dalších podrobností o chybě
relatedResource	ErrorRelatedResource	Podrobnosti o prostředku souvisejícím s chybou
requestId	string	ID požadavku přidruženého k chybě.

ErrorResponseDetails

Objekt

Podrobnosti o odpovědi na chybu.

Name	Typ	Description
errorCode	string	Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message	string	Lidské čitelné vyjádření chyby.
relatedResource	ErrorRelatedResource	Podrobnosti o prostředku souvisejícím s chybou

ItemTag

Objekt

Představuje značku použitou u položky.

Name	Typ	Description
displayName	string	Název značky.
id	string (uuid)	ID značky.

ItemType

Výčet

Typ položky. V průběhu času je možné přidat další typy položek.

Hodnota	Description
Dashboard	Řídicí panel PowerBI
Report	Sestava PowerBI
SemanticModel	Sémantický model PowerBI
PaginatedReport	Stránkovaná sestava PowerBI
Datamart	Datový diagram PowerBI
Lakehouse	Jezero.
Eventhouse	Eventhouse.
Environment	Prostředí.
KQLDatabase	Databáze KQL.
KQLQueryset	Sada dotazů KQL.
KQLDashboard	Řídicí panel KQL.
DataPipeline	Datový kanál.
Notebook	Poznámkový blok.
SparkJobDefinition	Definice úlohy Sparku.
MLExperiment	Experiment strojového učení.
MLModel	Model strojového učení.
Warehouse	Sklad.
Eventstream	Eventstream.
SQLEndpoint	Koncový bod SQL.
MirroredWarehouse	Zrcadlený sklad.
MirroredDatabase	Zrcadlené databáze.
Reflex	A Reflex.
GraphQLApi	Rozhraní API pro položku GraphQL
MountedDataFactory	A MountedDataFactory.
SQLDatabase	Databáze SQLDatabase.
CopyJob	Úloha kopírování.
VariableLibrary	ProměnnáLibrary.
Dataflow	Tok dat.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Snímek skladu.
DigitalTwinBuilder	A DigitalTwinBuilder.
DigitalTwinBuilderFlow	Tok digitálního dvojčete.
MirroredAzureDatabricksCatalog	Zrcadlený katalog Azure Databricks.
Map	Mapa.
AnomalyDetector	Detektor anomálií.
UserDataFunction	Funkce uživatelských dat.
GraphModel	A GraphModel.
GraphQuerySet	Sada dotazů grafu.
SnowflakeDatabase	Snowflake Database pro ukládání tabulek Iceberg vytvořených z účtu Snowflake.
OperationsAgent	A OperationsAgent.
CosmosDBDatabase	Databáze Cosmos DB.

MirroredDatabase

Objekt

Zrcadlená položka databáze.

Name	Typ	Description
description	string	Popis položky.
displayName	string	Zobrazovaný název položky.
folderId	string (uuid)	ID složky.
id	string (uuid)	ID položky.
properties	MirroredDatabaseProperties	Vlastnosti zrcadlené databáze.
tags	ItemTag[]	Seznam použitých značek
type	ItemType	Typ položky.
workspaceId	string (uuid)	ID pracovního prostoru.

MirroredDatabaseDefinition

Objekt

Zrcadlený objekt veřejné definice databáze.

Name	Typ	Description
parts	MirroredDatabaseDefinitionPart[]	Seznam částí definice.

MirroredDatabaseDefinitionPart

Objekt

Zrcadlený objekt části definice databáze.

Name	Typ	Description
path	string	Cesta k části zrcadlené databáze.
payload	string	Datová část zrcadlené databáze.
payloadType	PayloadType	Typ datové části.

MirroredDatabaseProperties

Objekt

Vlastnosti zrcadlené databáze.

Name	Typ	Description
defaultSchema	string	Výchozí schéma zrcadlené databáze Tato vlastnost je vrácena pouze pro zrcadlené databáze, která umožňuje výchozí schéma v definici.
oneLakeTablesPath	string	Cesta OneLake k adresáři zrcadlených databázových tabulek.
sqlEndpointProperties	SqlEndpointProperties	Objekt obsahující vlastnosti koncového bodu SQL.

PayloadType

Výčet

Typ datové části definice. V průběhu času je možné přidat další typy datových částí.

Hodnota	Description
InlineBase64	Vložená základna 64.

SqlEndpointProperties

Objekt

Objekt obsahující vlastnosti koncového bodu SQL.

Name	Typ	Description
connectionString	string	Připojovací řetězec koncového bodu SQL
id	string	ID koncového bodu SQL
provisioningStatus	SqlEndpointProvisioningStatus	Stav zřizování koncového bodu SQL

SqlEndpointProvisioningStatus

Výčet

Typ stavu zřizování koncového bodu SQL. V průběhu času je možné přidat další typy SqlEndpointProvisioningStatus.

Hodnota	Description
InProgress	Probíhá zřizování koncových bodů SQL.
Success	Zřízení koncového bodu SQL bylo úspěšné.
Failed	Zřizování koncového bodu SQL se nezdařilo.

Sdílet prostřednictvím

Items - Create Mirrored Database

Dovolení

Požadované delegovaná rozsahy

Podporované identity Microsoft Entra

Rozhraní

Parametry identifikátoru URI

Text požadavku

Odpovědi

Příklady

Create a mirrored database with public definition example

Ukázkový požadavek

Ukázková odpověď

Definice

CreateMirroredDatabaseRequest

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemTag

ItemType

MirroredDatabase

MirroredDatabaseDefinition

MirroredDatabaseDefinitionPart

MirroredDatabaseProperties

PayloadType

SqlEndpointProperties

SqlEndpointProvisioningStatus