Delen via

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 een werkruimterol inzender hebben.

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

gebruikersinterface

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

string (uuid)

De map-id. Als deze niet is opgegeven of null, wordt de gespiegelde database gemaakt met de werkruimte als map.

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.

  • WorkspaceItemsLimitExceeded - Limiet voor werkruimte-items is overschreden.

Voorbeelden

Create a mirrored database with public definition example

Voorbeeldaanvraag

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

Vertegenwoordigt een tag die is toegepast op een item.
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.
folderId

string (uuid)

De map-id. Als deze niet is opgegeven of null, wordt de gespiegelde database gemaakt met de werkruimte als map.

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.

ItemTag

Object

Vertegenwoordigt een tag die is toegepast op een item.

Name Type Description
displayName

string

De naam van de tag.
id

string (uuid)

De tag-id.

ItemType

Inventarisatie

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

Waarde Description
Dashboard

PowerBI-dashboard.
Report

PowerBI-rapport.
SemanticModel

Semantisch Power BI-model.
PaginatedReport

Gepagineerd Power BI-rapport.
Datamart

PowerBI-datamart.
Lakehouse

Een lakehouse.
Eventhouse

Een eventhouse.
Environment

Een omgeving.
KQLDatabase

Een KQL-database.
KQLQueryset

Een KQL-queryset.
KQLDashboard

Een KQL-dashboard.
DataPipeline

Een gegevenspijplijn.
Notebook

Een notitieblok.
SparkJobDefinition

Een Spark-taakdefinitie.
MLExperiment

Een machine learning-experiment.
MLModel

Een machine learning-model.
Warehouse

Een magazijn.
Eventstream

Een eventstream.
SQLEndpoint

Een SQL-eindpunt.
MirroredWarehouse

Een gespiegeld magazijn.
MirroredDatabase

Een gespiegelde database.
Reflex

Een reflex.
GraphQLApi

Een API voor GraphQL-item.
MountedDataFactory

Een MountedDataFactory.
SQLDatabase

Een SQLDatabase.
CopyJob

Een kopieertaak.
VariableLibrary

Een VariableLibrary.
Dataflow

Een gegevensstroom.
ApacheAirflowJob

Een ApacheAirflowJob.
WarehouseSnapshot

Een momentopname van een magazijn.
DigitalTwinBuilder

Een DigitalTwinBuilder.
DigitalTwinBuilderFlow

Een Digital Twin Builder Flow.
MirroredAzureDatabricksCatalog

Een gespiegelde Azure Databricks-catalogus.
Map

Een kaart.
AnomalyDetector

Een Anomaly Detector.
UserDataFunction

Een gebruikersgegevensfunctie.
GraphModel

Een GraphModel.
GraphQuerySet

Een Graph QuerySet.

MirroredDatabase

Object

Een gespiegeld database-item.

Name Type Description
description

string

De beschrijving van het item.
displayName

string

De weergavenaam van het item.
folderId

string (uuid)

De map-id.
id

string (uuid)

De item-id.
properties

MirroredDatabaseProperties

De eigenschappen van de gespiegelde database.
tags

ItemTag[]

Lijst met toegepaste tags.
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
InProgress

Het inrichten van SQL-eindpunten wordt uitgevoerd.
Success

Het inrichten van SQL-eindpunten is voltooid.
Failed

Inrichten van SQL-eindpunt is mislukt.