Items - Create Mirrored Database

Service:

MirroredDatabase

API-versie:

v1

Hiermee maakt u een gespiegelde database in de opgegeven werkruimte.
Deze API biedt geen ondersteuning voor het maken van een gespiegelde database zonder definitie. Raadpleeg gespiegelde databasedefinitie artikel voor het maken van een gespiegelde database met definitie.

Machtigingen

De aanroeper moet inzender hebben of een hogere werkruimterol.

Vereiste gedelegeerde bereiken

MirroredDatabase.ReadWrite.All of Item.ReadWrite.All

Door Microsoft Entra ondersteunde identiteiten

Deze API ondersteunt de Microsoft -identiteiten vermeld in deze sectie.

Identiteit	Steunen
Gebruiker	Ja
service-principal en beheerde identiteiten	Ja

Interface

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

URI-parameters

Name	In	Vereist	Type	Description
workspaceId	path	True	string uuid	De werkruimte-id.

Aanvraagbody

Name	Vereist	Type	Description
definition	True	MirroredDatabaseDefinition	De openbare definitie van de gespiegelde database.
displayName	True	string	De weergavenaam van de gespiegelde database. De weergavenaam moet de naamgevingsregels volgen op basis van het itemtype.
description		string	De beschrijving van de gespiegelde database. De maximale lengte is 256 tekens.

Antwoorden

Name	Type	Description
201 Created	MirroredDatabase	Gemaakt
Other Status Codes	ErrorResponse	Veelvoorkomende foutcodes: InvalidItemType - Itemtype is ongeldig ItemDisplayNameAlreadyInUse - Weergavenaam van item wordt al gebruikt. CorruptedPayload: de opgegeven nettolading is beschadigd.

Voorbeelden

Create a mirrored database with public definition example

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:

201

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

Definities

Name	Description
CreateMirroredDatabaseRequest	Maak de nettolading van een gespiegelde databaseaanvraag.
ErrorRelatedResource	Het foutgerelateerde resourcedetailsobject.
ErrorResponse	Het foutbericht.
ErrorResponseDetails	De details van het foutbericht.
ItemType	Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.
MirroredDatabase	Een gespiegeld database-item.
MirroredDatabaseDefinition	Gespiegeld openbaar definitieobject voor database.
MirroredDatabaseDefinitionPart	Gespiegeld databasedefinitieonderdeelobject.
MirroredDatabaseProperties	De eigenschappen van de gespiegelde database.
PayloadType	Het type nettolading van het definitieonderdeel. Er kunnen in de loop van de tijd extra typen nettoladingen worden toegevoegd.
SqlEndpointProperties	Een object met de eigenschappen van het SQL-eindpunt.
SqlEndpointProvisioningStatus	Het inrichtingsstatustype van het SQL-eindpunt. Er kunnen in de loop van de tijd extra SqlEndpointProvisioningStatus typen worden toegevoegd.

CreateMirroredDatabaseRequest

Object

Maak de nettolading van een gespiegelde databaseaanvraag.

Name	Type	Description
definition	MirroredDatabaseDefinition	De openbare definitie van de gespiegelde database.
description	string	De beschrijving van de gespiegelde database. De maximale lengte is 256 tekens.
displayName	string	De weergavenaam van de gespiegelde database. De weergavenaam moet de naamgevingsregels volgen op basis van het itemtype.

ErrorRelatedResource

Object

Het foutgerelateerde resourcedetailsobject.

Name	Type	Description
resourceId	string	De resource-id die betrokken is bij de fout.
resourceType	string	Het type resource dat betrokken is bij de fout.

ErrorResponse

Object

Het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
moreDetails	ErrorResponseDetails[]	Lijst met aanvullende foutdetails.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.
requestId	string	Id van de aanvraag die is gekoppeld aan de fout.

ErrorResponseDetails

Object

De details van het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.

ItemType

Inventarisatie

Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.

Waarde	Description
Dashboard	PowerBI-dashboard.
DataPipeline	Een gegevenspijplijn.
Datamart	PowerBI-datamart.
Environment	Een omgeving.
Eventhouse	Een eventhouse.
Eventstream	Een eventstream.
GraphQLApi	Een API voor GraphQL-item.
KQLDashboard	Een KQL-dashboard.
KQLDatabase	Een KQL-database.
KQLQueryset	Een KQL-queryset.
Lakehouse	Een lakehouse.
MLExperiment	Een machine learning-experiment.
MLModel	Een machine learning-model.
MirroredDatabase	Een gespiegelde database.
MirroredWarehouse	Een gespiegeld magazijn.
MountedDataFactory	Een MountedDataFactory.
Notebook	Een notitieblok.
PaginatedReport	Gepagineerd Power BI-rapport.
Reflex	Een reflex.
Report	PowerBI-rapport.
SQLDatabase	Een SQLDatabase.
SQLEndpoint	Een SQL-eindpunt.
SemanticModel	Semantisch Power BI-model.
SparkJobDefinition	Een Spark-taakdefinitie.
Warehouse	Een magazijn.

MirroredDatabase

Object

Een gespiegeld database-item.

Name	Type	Description
description	string	De beschrijving van het item.
displayName	string	De weergavenaam van het item.
id	string uuid	De item-id.
properties	MirroredDatabaseProperties	De eigenschappen van de gespiegelde database.
type	ItemType	Het itemtype.
workspaceId	string uuid	De werkruimte-id.

MirroredDatabaseDefinition

Object

Gespiegeld openbaar definitieobject voor database.

Name	Type	Description
parts	MirroredDatabaseDefinitionPart[]	Een lijst met definitieonderdelen.

MirroredDatabaseDefinitionPart

Object

Gespiegeld databasedefinitieonderdeelobject.

Name	Type	Description
path	string	Het pad naar het gespiegelde databaseonderdeel.
payload	string	De nettolading van het gespiegelde databaseonderdeel.
payloadType	PayloadType	Het nettoladingstype.

MirroredDatabaseProperties

Object

De eigenschappen van de gespiegelde database.

Name	Type	Description
defaultSchema	string	Standaardschema van de gespiegelde database. Deze eigenschap wordt alleen geretourneerd voor een gespiegelde database die standaardschema in de definitie inschakelt.
oneLakeTablesPath	string	OneLake-pad naar de map met gespiegelde databasetabellen.
sqlEndpointProperties	SqlEndpointProperties	Een object met de eigenschappen van het SQL-eindpunt.

PayloadType

Inventarisatie

Het type nettolading van het definitieonderdeel. Er kunnen in de loop van de tijd extra typen nettoladingen worden toegevoegd.

Waarde	Description
InlineBase64	Inline base 64.

SqlEndpointProperties

Object

Een object met de eigenschappen van het SQL-eindpunt.

Name	Type	Description
connectionString	string	Verbindingsreeks voor SQL-eindpunt.
id	string	SQL-eindpunt-id.
provisioningStatus	SqlEndpointProvisioningStatus	De inrichtingsstatus van het SQL-eindpunt.

SqlEndpointProvisioningStatus

Inventarisatie

Het inrichtingsstatustype van het SQL-eindpunt. Er kunnen in de loop van de tijd extra SqlEndpointProvisioningStatus typen worden toegevoegd.

Waarde	Description
Failed	Inrichten van SQL-eindpunt is mislukt.
InProgress	Het inrichten van SQL-eindpunten wordt uitgevoerd.
Success	Het inrichten van SQL-eindpunten is voltooid.