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

Microsoft Entra podporované identity

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

Identita Podpora
Uživatel Ano
Hlavní služba 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.
sensitivityLabelSettings

SensitivityLabelSettings

Nastavení popisku citlivosti pro zrcadlenou databázi.

Odpovědi

Name Typ Description
201 Created

MirroredDatabase

Úspěšně vytvořeno
429 Too Many Requests

ErrorResponse

Byl překročen limit přenosové rychlosti služby. Server vrátí hlavičku označující Retry-After , jak dlouho musí klient čekat před odesláním dalších požadavků.

Hlavičky

Retry-After: integer
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

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",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}

Definice

Name Description
CreateMirroredDatabaseRequest

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

Představuje objekt zabezpečení tenanta.
ErrorParameter

Strukturovaný parametr poskytující další strojově čitelný kontext chyby.
ErrorRelatedResource

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

Odpověď na chybu.
ErrorResponseDetails

Podrobnosti o odpovědi na chybu.
GroupDetails

Seskupte konkrétní podrobnosti. Použitelné, pokud je typ objektu zabezpečení Group.
GroupPrincipal

Představuje skupinu zabezpečení.
GroupType

Typ skupiny. V průběhu času je možné přidat další typy skupin.
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. Další podrobnosti o struktuře definice zrcadlené databáze najdete v tomto článku .
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í.
PrincipalType

Typ objektu zabezpečení. V průběhu času je možné přidat další typy objektů zabezpečení.
SensitivityLabel

Představuje popisek citlivosti použitý u položky.
SensitivityLabelApplyStrategy

Strategie použití popisku citlivosti Výchozí hodnota je ApplyOrFail. V průběhu času je možné přidat další typy.
SensitivityLabelSettings

Nastavení popisku citlivosti.
ServicePrincipalDetails

Podrobnosti specifické pro instanční objekt Použitelné, pokud je typ objektu zabezpečení ServicePrincipal.
ServicePrincipalPrincipal

Představuje Microsoft Entra instanční objekt.
ServicePrincipalProfileDetails

Podrobnosti profilu instančního objektu Použitelné, pokud je typ objektu zabezpečení ServicePrincipalProfile.
ServicePrincipalProfilePrincipal

Představuje profil instančního objektu.
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.
UserDetails

Podrobnosti specifické pro objekt zabezpečení uživatele. Použitelné, pokud je typ objektu zabezpečení User.
UserPrincipal

Představuje Microsoft Entra objekt zabezpečení uživatele.

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

SensitivityLabelSettings

Nastavení popisku citlivosti pro zrcadlenou databázi.

EntireTenantPrincipal

Objekt

Představuje objekt zabezpečení tenanta.

Name Typ Description
displayName

string

Zobrazovaný název objektu zabezpečení.
id

string (uuid)

ID objektu zabezpečení.
type string:

EntireTenant

Typ objektu zabezpečení. V průběhu času je možné přidat další typy objektů zabezpečení.

ErrorParameter

Objekt

Strukturovaný parametr poskytující další strojově čitelný kontext chyby.

Name Typ Description
message

string

Popis významu parametru čitelný člověkem.
name

string

Identifikátor parametru.
value

string

Hodnota parametru.

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

boolean

Pokud je hodnota true, je možné požadavek opakovat. Pomocí hlavičky Retry-After odpovědi určete zpoždění, pokud je k dispozici.
message

string

Lidské čitelné vyjádření chyby.
moreDetails

ErrorResponseDetails[]

Seznam dalších podrobností o chybě
parameters

ErrorParameter[]

Strukturované parametry poskytují další strojově čitelný kontext chyby.
relatedResource

ErrorRelatedResource

Podrobnosti o prostředku souvisejícím s chybou
requestId

string (uuid)

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

ErrorParameter[]

Strukturované parametry poskytují další strojově čitelný kontext chyby.
relatedResource

ErrorRelatedResource

Podrobnosti o prostředku souvisejícím s chybou

GroupDetails

Objekt

Seskupte konkrétní podrobnosti. Použitelné, pokud je typ objektu zabezpečení Group.

Name Typ Description
groupType

GroupType

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

GroupPrincipal

Objekt

Představuje skupinu zabezpečení.

Name Typ Description
displayName

string

Zobrazovaný název objektu zabezpečení.
groupDetails

GroupDetails

Seskupte konkrétní podrobnosti. Použitelné, pokud je typ objektu zabezpečení Group.
id

string (uuid)

ID objektu zabezpečení.
type string:

Group

Typ objektu zabezpečení. V průběhu času je možné přidat další typy objektů zabezpečení.

GroupType

Výčet

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

Hodnota Description
Unknown

Typ hlavní skupiny je neznámý.
SecurityGroup

Objekt zabezpečení je skupina zabezpečení.
DistributionList

Objekt zabezpečení je distribuční seznam.

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

Ontologie.
EventSchemaSet

An EventSchemaSet.
DataAgent

A DataAgent.
MirroredCatalog

ZrcadlenýCatalog.
AppBackend

An AppBackend.
OrgApp

Aplikace organizace.
OrgAppAudience

Cílová skupina aplikace organizace.
DataBuildToolJob

A DataBuildToolJob.
AzureDatabricksStorage

Položka úložiště založené na OneLake pro Azure Databricks.
Plan

Plán.

MirroredDatabase

Objekt

Zrcadlená položka databáze.

Name Typ Description
defaultIdentity Principal:

Výchozí identita položky
description

string

Popis položky.
displayName

string

Zobrazovaný název položky.
folderId

string (uuid)

ID složky.
id

string (uuid)

ID položky.
logicalId

string (uuid)

Logický identifikátor položky. Odpovídající instance položek sdílejí stejné logické ID. Hodnota má hodnotu null, pokud není přiřazeno žádné logické ID.
properties

MirroredDatabaseProperties

Vlastnosti zrcadlené databáze.
sensitivityLabel

SensitivityLabel

Popisek citlivosti položky.
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. Další podrobnosti o struktuře definice zrcadlené databáze najdete v tomto článku .

Name Typ Description
format

string

Formát definice zrcadlené databáze.
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.

PrincipalType

Výčet

Typ objektu zabezpečení. V průběhu času je možné přidat další typy objektů zabezpečení.

Hodnota Description
User

Objekt zabezpečení je Microsoft Entra objekt zabezpečení uživatele.
ServicePrincipal

Instanční objekt je Microsoft Entra instanční objekt.
Group

Objekt zabezpečení je skupina zabezpečení.
ServicePrincipalProfile

Instanční objekt je profil instančního objektu.
EntireTenant

Objekt zabezpečení představuje všechny uživatele tenanta.

SensitivityLabel

Objekt

Představuje popisek citlivosti použitý u položky.

Name Typ Description
id

string (uuid)

ID popisku citlivosti.

SensitivityLabelApplyStrategy

Výčet

Strategie použití popisku citlivosti Výchozí hodnota je ApplyOrFail. V průběhu času je možné přidat další typy.

Hodnota Description
ApplyOrFail

Pokud ho nelze použít, použijte popisek citlivosti nebo operaci selžou.
Ignore

Pokud popisek citlivosti nelze použít, ignorujte ho a pokračujte v operaci bez použití popisku.

SensitivityLabelSettings

Objekt

Nastavení popisku citlivosti.

Name Typ Description
labelId

string (uuid)

ID popisku citlivosti.
sensitivityLabelApplyStrategy

SensitivityLabelApplyStrategy

Strategie použití popisku citlivosti

ServicePrincipalDetails

Objekt

Podrobnosti specifické pro instanční objekt Použitelné, pokud je typ objektu zabezpečení ServicePrincipal.

Name Typ Description
aadAppId

string (uuid)

Instanční objekt Microsoft Entra AppId.

ServicePrincipalPrincipal

Objekt

Představuje Microsoft Entra instanční objekt.

Name Typ Description
displayName

string

Zobrazovaný název objektu zabezpečení.
id

string (uuid)

ID objektu zabezpečení.
servicePrincipalDetails

ServicePrincipalDetails

Podrobnosti specifické pro instanční objekt Použitelné, pokud je typ objektu zabezpečení ServicePrincipal.
type string:

ServicePrincipal

Typ objektu zabezpečení. V průběhu času je možné přidat další typy objektů zabezpečení.

ServicePrincipalProfileDetails

Objekt

Podrobnosti profilu instančního objektu Použitelné, pokud je typ objektu zabezpečení ServicePrincipalProfile.

Name Typ Description
parentPrincipal Principal:

Nadřazený objekt profilu instančního objektu.

ServicePrincipalProfilePrincipal

Objekt

Představuje profil instančního objektu.

Name Typ Description
displayName

string

Zobrazovaný název objektu zabezpečení.
id

string (uuid)

ID objektu zabezpečení.
servicePrincipalProfileDetails

ServicePrincipalProfileDetails

Podrobnosti profilu instančního objektu Použitelné, pokud je typ objektu zabezpečení ServicePrincipalProfile.
type string:

ServicePrincipalProfile

Typ objektu zabezpečení. V průběhu času je možné přidat další typy objektů zabezpečení.

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.

UserDetails

Objekt

Podrobnosti specifické pro objekt zabezpečení uživatele. Použitelné, pokud je typ objektu zabezpečení User.

Name Typ Description
userPrincipalName

string

Jméno hlavního uživatele.

UserPrincipal

Objekt

Představuje Microsoft Entra objekt zabezpečení uživatele.

Name Typ Description
displayName

string

Zobrazovaný název objektu zabezpečení.
id

string (uuid)

ID objektu zabezpečení.
type string:

User

Typ objektu zabezpečení. V průběhu času je možné přidat další typy objektů zabezpečení.
userDetails

UserDetails

Podrobnosti specifické pro objekt zabezpečení uživatele. Použitelné, pokud je typ objektu zabezpečení User.