Items - Create Mirrored Database

Tjänst:: MirroredDatabase

API-version:: v1

Skapar en speglad databas på den angivna arbetsytan.
Det här API:et har inte stöd för att skapa en speglad databas utan en definition. Om du vill skapa en speglad databas med definition läser du artikeln Speglad databasdefinition.

Behörigheter

Anroparen måste ha rollen deltagare i arbetsytan.

Obligatoriska delegerade omfång

MirroredDatabase.ReadWrite.All eller Item.ReadWrite.All

Identiteter som stöds av Microsoft Entra

Det här API:et stöder Microsoft identiteter som anges i det här avsnittet.

Identitet	Stöd
Användare	Ja
Tjänstens huvudnamn och hanterade identiteter	Ja

Gränssnitt

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
workspaceId	path	True	string (uuid)	Arbetsytans ID.

Begärandetext

Name	Obligatorisk	Typ	Description
definition	True	MirroredDatabaseDefinition	Den speglade offentliga definitionen för databasen.
displayName	True	string	Visningsnamnet för den speglade databasen. Visningsnamnet måste följa namngivningsreglerna efter objekttyp.
description		string	Beskrivningen av den speglade databasen. Maximal längd är 256 tecken.
folderId		string (uuid)	Mapp-ID:t. Om den inte anges eller är null skapas den speglade databasen med arbetsytan som mapp.

Svar

Name	Typ	Description
201 Created	MirroredDatabase	Har skapats
Other Status Codes	ErrorResponse	Vanliga felkoder: InvalidItemType – Objekttypen är ogiltig ItemDisplayNameAlreadyInUse – Objektets visningsnamn används redan. CorruptedPayload – den angivna nyttolasten är skadad. WorkspaceItemsLimitExceeded – Gränsen för arbetsyteobjekt har överskridits.

Name

Typ

Description

201 Created

MirroredDatabase

Har skapats

Other Status Codes

ErrorResponse

Vanliga felkoder:

InvalidItemType – Objekttypen är ogiltig
ItemDisplayNameAlreadyInUse – Objektets visningsnamn används redan.
CorruptedPayload – den angivna nyttolasten är skadad.
WorkspaceItemsLimitExceeded – Gränsen för arbetsyteobjekt har överskridits.

Exempel

Create a mirrored database with public definition example

Exempelbegäran

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

Exempelsvar

Statuskod:: 201

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

Definitioner

Name	Description
CreateMirroredDatabaseRequest	Skapa en speglingsnyttolast för databasbegäran.
ErrorRelatedResource	Det felrelaterade resursinformationsobjektet.
ErrorResponse	Felsvaret.
ErrorResponseDetails	Information om felsvar.
ItemTag	Representerar en tagg som tillämpas på ett objekt.
ItemType	Typ av objekt. Ytterligare objekttyper kan läggas till över tid.
MirroredDatabase	Ett speglat databasobjekt.
MirroredDatabaseDefinition	Speglat offentligt definitionsobjekt för databasen.
MirroredDatabaseDefinitionPart	Speglat databasdefinitionsdelsobjekt.
MirroredDatabaseProperties	Egenskaperna för den speglade databasen.
PayloadType	Typ av definitionsdelens nyttolast. Ytterligare nyttolasttyper kan läggas till över tid.
SqlEndpointProperties	Ett objekt som innehåller egenskaperna för SQL-slutpunkten.
SqlEndpointProvisioningStatus	Statustyp för SQL-slutpunktsetablering. Ytterligare `SqlEndpointProvisioningStatus` typer kan läggas till över tid.

CreateMirroredDatabaseRequest

Objekt

Skapa en speglingsnyttolast för databasbegäran.

Name	Typ	Description
definition	MirroredDatabaseDefinition	Den speglade offentliga definitionen för databasen.
description	string	Beskrivningen av den speglade databasen. Maximal längd är 256 tecken.
displayName	string	Visningsnamnet för den speglade databasen. Visningsnamnet måste följa namngivningsreglerna efter objekttyp.
folderId	string (uuid)	Mapp-ID:t. Om den inte anges eller är null skapas den speglade databasen med arbetsytan som mapp.

ErrorRelatedResource

Objekt

Det felrelaterade resursinformationsobjektet.

Name	Typ	Description
resourceId	string	Det resurs-ID som ingår i felet.
resourceType	string	Typen av resurs som är inblandad i felet.

ErrorResponse

Objekt

Felsvaret.

Name	Typ	Description
errorCode	string	En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message	string	En mänsklig läsbar representation av felet.
moreDetails	ErrorResponseDetails[]	Lista över ytterligare felinformation.
relatedResource	ErrorRelatedResource	Felrelaterad resursinformation.
requestId	string	ID för den begäran som är associerad med felet.

ErrorResponseDetails

Objekt

Information om felsvar.

Name	Typ	Description
errorCode	string	En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message	string	En mänsklig läsbar representation av felet.
relatedResource	ErrorRelatedResource	Felrelaterad resursinformation.

ItemTag

Objekt

Representerar en tagg som tillämpas på ett objekt.

Name	Typ	Description
displayName	string	Namnet på taggen.
id	string (uuid)	Tagg-ID:t.

ItemType

Uppräkning

Typ av objekt. Ytterligare objekttyper kan läggas till över tid.

Värde	Description
Dashboard	PowerBI-instrumentpanel.
Report	PowerBI-rapport.
SemanticModel	PowerBI-semantisk modell.
PaginatedReport	Sidnumrerad PowerBI-rapport.
Datamart	PowerBI-datamart.
Lakehouse	Ett sjöhus.
Eventhouse	Ett eventhouse.
Environment	En miljö.
KQLDatabase	En KQL-databas.
KQLQueryset	En KQL-frågeuppsättning.
KQLDashboard	En KQL-instrumentpanel.
DataPipeline	En datapipeline.
Notebook	En notebook-fil.
SparkJobDefinition	En definition för Spark-jobb.
MLExperiment	Ett maskininlärningsexperiment.
MLModel	En maskininlärningsmodell.
Warehouse	Ett lager.
Eventstream	En händelseström.
SQLEndpoint	En SQL-slutpunkt.
MirroredWarehouse	Ett speglat lager.
MirroredDatabase	En speglad databas.
Reflex	En reflex.
GraphQLApi	Ett API för GraphQL-objekt.
MountedDataFactory	En MountedDataFactory.
SQLDatabase	En SQLDatabase.
CopyJob	Ett kopieringsjobb.
VariableLibrary	En VariableLibrary.
Dataflow	Ett dataflöde.
ApacheAirflowJob	Ett ApacheAirflowJob.
WarehouseSnapshot	En ögonblicksbild av lagret.
DigitalTwinBuilder	En DigitalTwinBuilder.
DigitalTwinBuilderFlow	Ett Digital Twin Builder Flow.
MirroredAzureDatabricksCatalog	En speglad azure databricks-katalog.
Map	En karta.
AnomalyDetector	En avvikelseidentifiering.
UserDataFunction	En användardatafunktion.
GraphModel	En GraphModel.
GraphQuerySet	En Graph QuerySet.

MirroredDatabase

Objekt

Ett speglat databasobjekt.

Name	Typ	Description
description	string	Objektbeskrivningen.
displayName	string	Objektets visningsnamn.
folderId	string (uuid)	Mapp-ID:t.
id	string (uuid)	Objekt-ID:t.
properties	MirroredDatabaseProperties	Egenskaperna för den speglade databasen.
tags	ItemTag[]	Lista över tillämpade taggar.
type	ItemType	Objekttypen.
workspaceId	string (uuid)	Arbetsytans ID.

MirroredDatabaseDefinition

Objekt

Speglat offentligt definitionsobjekt för databasen.

Name	Typ	Description
parts	MirroredDatabaseDefinitionPart[]	En lista över definitionsdelar.

MirroredDatabaseDefinitionPart

Objekt

Speglat databasdefinitionsdelsobjekt.

Name	Typ	Description
path	string	Den speglade databasdelssökvägen.
payload	string	Den speglade databasdelens nyttolast.
payloadType	PayloadType	Nyttolasttypen.

MirroredDatabaseProperties

Objekt

Egenskaperna för den speglade databasen.

Name	Typ	Description
defaultSchema	string	Standardschema för den speglade databasen. Den här egenskapen returneras endast för speglad databas som aktiverar standardschema i definitionen.
oneLakeTablesPath	string	OneLake-sökväg till katalogen med speglade databastabeller.
sqlEndpointProperties	SqlEndpointProperties	Ett objekt som innehåller egenskaperna för SQL-slutpunkten.

PayloadType

Uppräkning

Typ av definitionsdelens nyttolast. Ytterligare nyttolasttyper kan läggas till över tid.

Värde	Description
InlineBase64	Infogad bas 64.

SqlEndpointProperties

Objekt

Ett objekt som innehåller egenskaperna för SQL-slutpunkten.

Name	Typ	Description
connectionString	string	SQL-slutpunktsanslutningssträng.
id	string	SQL-slutpunkts-ID.
provisioningStatus	SqlEndpointProvisioningStatus	SQL-slutpunktsetableringsstatus.

SqlEndpointProvisioningStatus

Uppräkning

Statustyp för SQL-slutpunktsetablering. Ytterligare SqlEndpointProvisioningStatus typer kan läggas till över tid.

Värde	Description
InProgress	SQL-slutpunktsetablering pågår.
Success	SQL-slutpunktsetablering lyckades.
Failed	SQL-slutpunktsetablering misslyckades.

Dela via

Items - Create Mirrored Database

Behörigheter

Obligatoriska delegerade omfång

Identiteter som stöds av Microsoft Entra

Gränssnitt

URI-parametrar

Begärandetext

Svar

Exempel

Create a mirrored database with public definition example

Exempelbegäran

Exempelsvar

Definitioner

CreateMirroredDatabaseRequest

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemTag

ItemType

MirroredDatabase

MirroredDatabaseDefinition

MirroredDatabaseDefinitionPart

MirroredDatabaseProperties

PayloadType

SqlEndpointProperties

SqlEndpointProvisioningStatus