Items - Create SQL Database

Usługa:: SQLDatabase

Wersja interfejsu API:: v1

Tworzy bazę danych SQL w określonym obszarze roboczym.
Ten interfejs API obsługuje długotrwałych operacji (LRO).

Aby utworzyć bazę danych SQL z definicją publiczną, zapoznaj się z artykułem dotyczącym definicji bazy danych SQLDatabase .

Permissions

Obiekt wywołujący musi mieć rolę obszaru roboczego współautora .

Wymagane zakresy delegowane

SQLDatabase.ReadWrite.All lub Item.ReadWrite.All

Limitations

Aby utworzyć bazę danych SQL, obszar roboczy musi znajdować się w obsługiwanej pojemności Fabric. Aby uzyskać więcej informacji, zobacz: typy licencji Microsoft Fabric.

Microsoft Entra obsługiwane tożsamości

Ten interfejs API obsługuje Microsoft identities wymienione w tej sekcji.

Identity	Support
User	Yes
Główne usługi i Tożsamości zarządzane	Yes

Interface

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
workspaceId	path	True	string (uuid)	Identyfikator obszaru roboczego.

Treść żądania

Nazwa	Wymagane	Typ	Opis
displayName	True	string	Nazwa wyświetlana bazy danych SQL. Nazwa wyświetlana musi być zgodna z regułami nazewnictwa zgodnie z typem elementu.
creationPayload		SQLDatabaseCreationPayload: NewSQLDatabaseCreationPayload RestoreSQLDatabaseCreationPayload RestoreDeletedDatabaseCreationPayload	Ładunek tworzenia bazy danych SQL.
definition		SQLDatabaseDefinition	Definicja bazy danych SQL.
description		string	Opis bazy danych SQL. Maksymalna długość to 256 znaków.
folderId		string (uuid)	Identyfikator folderu. Jeśli nie zostanie określona lub ma wartość null, baza danych SQL zostanie utworzona z obszarem roboczym jako jego folderem.
sensitivityLabelSettings		SensitivityLabelSettings	Ustawienia etykiety poufności dla bazy danych SQL.

Odpowiedzi

Nazwa	Typ	Opis
201 Created	SQLDatabase	Pomyślnie utworzono
202 Accepted		Żądanie zaakceptowane, trwa aprowizowanie bazy danych SQL. Nagłówki Location: string x-ms-operation-id: string Retry-After: integer
429 Too Many Requests	ErrorResponse	Przekroczono limit szybkości usługi. Serwer zwraca nagłówek wskazujący `Retry-After` w sekundach, jak długo klient musi czekać przed wysłaniem dodatkowych żądań. Nagłówki Retry-After: integer
Other Status Codes	ErrorResponse	Typowe kody błędów: InvalidItemType — typ elementu jest nieprawidłowy ItemDisplayNameAlreadyInUse — nazwa wyświetlana elementu jest już używana. CorruptedPayload — podany ładunek jest uszkodzony. WorkspaceItemsLimitExceeded — przekroczono limit elementu obszaru roboczego.

Przykłady

Create a SQLDatabase example

Create a SQLDatabase with definition example

Create a SQLDatabase with payload example

Create a SQLDatabase with payload of restore deleted database example

Create a SQLDatabase example

Przykładowe żądanie

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/sqlDatabases

{
  "displayName": "SQLDatabase 1",
  "description": "A SQLDatabase description."
}

Przykładowa odpowiedź

Kod stanu:: 201

{
  "displayName": "SQLDatabase 1",
  "description": "A SQLDatabase description.",
  "type": "SQLDatabase",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}

Kod stanu:: 202

Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Create a SQLDatabase with definition example

Przykładowe żądanie

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/sqlDatabases

{
  "displayName": "SQLDatabase1",
  "description": "A SQLDatabase description.",
  "definition": {
    "parts": [
      {
        "path": "definition.dacpac",
        "payload": "ew0KICAibGFrZWhvdXNlSWQiOiAiYjliNWQzNmYtNDQ0NS00MDNiLWFjODctMDE2YjFjZDIwMjExIg0KfQ==",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

Przykładowa odpowiedź

Kod stanu:: 201

{
  "displayName": "SQLDatabase 1",
  "description": "A SQLDatabase description.",
  "type": "SQLDatabase",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}

Kod stanu:: 202

Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Create a SQLDatabase with payload example

Przykładowe żądanie

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/sqlDatabases

{
  "displayName": "SQLDatabase1",
  "description": "A SQLDatabase description.",
  "creationPayload": {
    "creationMode": "Restore",
    "sourceDatabaseReference": {
      "referenceType": "ById",
      "itemId": "d96de2f4-7dd1-45ad-9ff6-37a2d6aa9861",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    },
    "restorePointInTime": "2024-12-01T00:00:00.000Z"
  }
}

Przykładowa odpowiedź

Kod stanu:: 201

{
  "displayName": "SQLDatabase 1",
  "description": "A SQLDatabase description.",
  "type": "SQLDatabase",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}

Kod stanu:: 202

Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Create a SQLDatabase with payload of restore deleted database example

Przykładowe żądanie

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/sqlDatabases

{
  "displayName": "SQLDatabase1",
  "description": "A SQLDatabase description.",
  "creationPayload": {
    "creationMode": "RestoreDeletedDatabase",
    "restorableDeletedDatabaseName": "deletedDatabaseName",
    "restorePointInTime": "2024-12-01T00:00:00.000Z"
  }
}

Przykładowa odpowiedź

Kod stanu:: 201

{
  "displayName": "SQLDatabase1",
  "description": "A SQLDatabase description.",
  "type": "SQLDatabase",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

Kod stanu:: 202

Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Definicje

Nazwa	Opis
CreateSQLDatabaseRequest	Utwórz ładunek żądania bazy danych SQL.
CreationMode	Tryb tworzenia ładunku tworzenia. Dodatkowe typy CreationMode można dodawać w czasie.
EntireTenantPrincipal	Reprezentuje podmiot zabezpieczeń dzierżawy
ErrorRelatedResource	Obiekt szczegółów zasobu powiązanego z błędem.
ErrorResponse	Odpowiedź na błąd.
ErrorResponseDetails	Szczegóły odpowiedzi na błąd.
GroupDetails	Grupuj szczegółowe informacje. Dotyczy, gdy typ podmiotu zabezpieczeń to `Group`.
GroupPrincipal	Reprezentuje grupę zabezpieczeń.
GroupType	Typ grupy. Dodatkowe typy grup mogą być dodawane w czasie.
ItemReferenceById	Odwołanie do elementu według obiektu ID.
ItemReferenceType	Typ odwołania do elementu. Dodatkowe typy `ItemReferenceType` można dodawać w czasie.
ItemTag	Reprezentuje tag zastosowany w elemencie.
ItemType	Typ elementu. Dodatkowe typy elementów można dodawać w czasie.
NewSQLDatabaseCreationPayload	Tworzenie ładunku tworzenia elementu bazy danych SQL z obsługiwanymi ustawieniami
PayloadType	Typ ładunku części definicji. Dodatkowe typy ładunków mogą być dodawane w czasie.
PrincipalType	Typ podmiotu zabezpieczeń. Dodatkowe typy podmiotów zabezpieczeń mogą być dodawane w czasie.
RestoreDeletedDatabaseCreationPayload	Uwaga / Notatka Funkcja PITR z usuniętych baz danych jest obecnie dostępna w wersji zapoznawczej (dowiedz się więcej). Tworzy element bazy danych SQL, przywracając z przywracalnej usuniętej bazy danych.
RestoreSQLDatabaseCreationPayload	Tworzenie ładunku tworzenia elementu bazy danych SQL przy użyciu przywracania ze źródłowej bazy danych
SensitivityLabel	Reprezentuje etykietę poufności zastosowaną do elementu.
SensitivityLabelApplyStrategy	Strategia stosowania etykiety poufności. Wartość domyślna to ApplyOrFail. Dodatkowe typy mogą być dodawane w czasie.
SensitivityLabelSettings	Ustawienia etykiety poufności.
ServicePrincipalDetails	Szczegóły dotyczące jednostki usługi. Dotyczy, gdy typ podmiotu zabezpieczeń to `ServicePrincipal`.
ServicePrincipalPrincipal	Reprezentuje Microsoft Entra jednostkę usługi.
ServicePrincipalProfileDetails	Szczegóły profilu jednostki usługi. Dotyczy, gdy typ podmiotu zabezpieczeń to `ServicePrincipalProfile`.
ServicePrincipalProfilePrincipal	Reprezentuje profil jednostki usługi.
SQLDatabase	Obiekt bazy danych SQL.
SQLDatabaseDefinition	Obiekt definicji publicznej bazy danych SQL. Zapoznaj się z tym artykułem , aby uzyskać więcej informacji na temat struktury definicji bazy danych SQL.
SQLDatabaseProperties	Właściwości bazy danych SQL.
SQLDatabasePublicDefinitionPart	Obiekt części definicji bazy danych SQL.
UserDetails	Szczegóły dotyczące podmiotu zabezpieczeń użytkownika. Dotyczy, gdy typ podmiotu zabezpieczeń to `User`.
UserPrincipal	Reprezentuje Microsoft Entra podmiot zabezpieczeń użytkownika.

CreateSQLDatabaseRequest

Objekt

Utwórz ładunek żądania bazy danych SQL.

Nazwa	Typ	Opis
creationPayload	SQLDatabaseCreationPayload: NewSQLDatabaseCreationPayload RestoreDeletedDatabaseCreationPayload RestoreSQLDatabaseCreationPayload	Ładunek tworzenia bazy danych SQL.
definition	SQLDatabaseDefinition	Definicja bazy danych SQL.
description	string	Opis bazy danych SQL. Maksymalna długość to 256 znaków.
displayName	string	Nazwa wyświetlana bazy danych SQL. Nazwa wyświetlana musi być zgodna z regułami nazewnictwa zgodnie z typem elementu.
folderId	string (uuid)	Identyfikator folderu. Jeśli nie zostanie określona lub ma wartość null, baza danych SQL zostanie utworzona z obszarem roboczym jako jego folderem.
sensitivityLabelSettings	SensitivityLabelSettings	Ustawienia etykiety poufności dla bazy danych SQL.

CreationMode

Wyliczenie

Tryb tworzenia ładunku tworzenia. Dodatkowe typy CreationMode można dodawać w czasie.

Wartość	Opis
New	Domyślny tryb tworzenia. Właściwości "backupRetentionDays" i "collation" są akceptowane w tym trybie.
Restore	Tryb tworzenia przywracania ze źródłowej bazy danych. Wymagane są właściwości "sourceDatabaseReference" i "restorePointInTime". Żadne inne właściwości nie są akceptowane.
RestoreDeletedDatabase	Tryb tworzenia na potrzeby przywracania z przywracalnej usuniętej bazy danych. Wymagane są właściwości "restoreableDeletedDatabaseName" i "restorePointInTime". Żadne inne właściwości nie są akceptowane.

EntireTenantPrincipal

Objekt

Reprezentuje podmiot zabezpieczeń dzierżawy

Nazwa	Typ	Opis
displayName	string	Nazwa wyświetlana podmiotu zabezpieczeń.
id	string (uuid)	Identyfikator podmiotu zabezpieczeń.
type	string: EntireTenant	Typ podmiotu zabezpieczeń. Dodatkowe typy podmiotów zabezpieczeń mogą być dodawane w czasie.

ErrorRelatedResource

Objekt

Obiekt szczegółów zasobu powiązanego z błędem.

Nazwa	Typ	Opis
resourceId	string	Identyfikator zasobu, który jest zaangażowany w błąd.
resourceType	string	Typ zasobu, który jest zaangażowany w błąd.

ErrorResponse

Objekt

Odpowiedź na błąd.

Nazwa	Typ	Opis
errorCode	string	Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
isRetriable	boolean	Jeśli to prawda, żądanie można ponowić. Użyj nagłówka `Retry-After` odpowiedzi, aby określić opóźnienie, jeśli jest dostępne.
message	string	Czytelna reprezentacja błędu przez człowieka.
moreDetails	ErrorResponseDetails[]	Lista dodatkowych szczegółów błędu.
relatedResource	ErrorRelatedResource	Szczegóły zasobu powiązanego z błędem.
requestId	string (uuid)	Identyfikator żądania skojarzonego z błędem.

ErrorResponseDetails

Objekt

Szczegóły odpowiedzi na błąd.

Nazwa	Typ	Opis
errorCode	string	Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
message	string	Czytelna reprezentacja błędu przez człowieka.
relatedResource	ErrorRelatedResource	Szczegóły zasobu powiązanego z błędem.

GroupDetails

Objekt

Grupuj szczegółowe informacje. Dotyczy, gdy typ podmiotu zabezpieczeń to Group.

Nazwa	Typ	Opis
groupType	GroupType	Typ grupy. Dodatkowe typy grup mogą być dodawane w czasie.

GroupPrincipal

Objekt

Reprezentuje grupę zabezpieczeń.

Nazwa	Typ	Opis
displayName	string	Nazwa wyświetlana podmiotu zabezpieczeń.
groupDetails	GroupDetails	Grupuj szczegółowe informacje. Dotyczy, gdy typ podmiotu zabezpieczeń to `Group`.
id	string (uuid)	Identyfikator podmiotu zabezpieczeń.
type	string: Group	Typ podmiotu zabezpieczeń. Dodatkowe typy podmiotów zabezpieczeń mogą być dodawane w czasie.

GroupType

Wyliczenie

Typ grupy. Dodatkowe typy grup mogą być dodawane w czasie.

Wartość	Opis
Unknown	Typ grupy podmiotu zabezpieczeń jest nieznany.
SecurityGroup	Podmiot zabezpieczeń jest grupą zabezpieczeń.
DistributionList	Podmiot zabezpieczeń jest listą dystrybucyjną.

ItemReferenceById

Objekt

Odwołanie do elementu według obiektu ID.

Nazwa	Typ	Opis
itemId	string (uuid)	Identyfikator elementu.
referenceType	string: ById	Typ odwołania do elementu.
workspaceId	string (uuid)	Identyfikator obszaru roboczego elementu.

ItemReferenceType

Wyliczenie

Typ odwołania do elementu. Dodatkowe typy ItemReferenceType można dodawać w czasie.

Wartość	Opis
ById	Element jest przywołyyny przez jego identyfikator.
ByVariable	Element jest przywołyyny przez zmienną.

ItemTag

Objekt

Reprezentuje tag zastosowany w elemencie.

Nazwa	Typ	Opis
displayName	string	Nazwa znacznika.
id	string (uuid)	Identyfikator tagu.

ItemType

Wyliczenie

Typ elementu. Dodatkowe typy elementów można dodawać w czasie.

Wartość	Opis
Dashboard	Pulpit nawigacyjny usługi Power BI.
Report	Raport usługi Power BI.
SemanticModel	Model semantyczny usługi PowerBI.
PaginatedReport	Raport podzielony na strony usługi PowerBI.
Datamart	Datamart usługi Power BI.
Lakehouse	Jezioro.
Eventhouse	Magazyn zdarzeń.
Environment	Środowisko.
KQLDatabase	Baza danych KQL.
KQLQueryset	Zestaw zapytań KQL.
KQLDashboard	Pulpit nawigacyjny KQL.
DataPipeline	Potok danych.
Notebook	Zeszyt.
SparkJobDefinition	Definicja zadania platformy Spark.
MLExperiment	Eksperyment uczenia maszynowego.
MLModel	Model uczenia maszynowego.
Warehouse	Magazyn.
Eventstream	Strumień zdarzeń.
SQLEndpoint	Punkt końcowy SQL.
MirroredWarehouse	Dublowany magazyn.
MirroredDatabase	Dublowana baza danych.
Reflex	Refleks.
GraphQLApi	Interfejs API dla elementu GraphQL.
MountedDataFactory	A MountedDataFactory.
SQLDatabase	Baza danych SQLDatabase.
CopyJob	Zadanie kopiowania.
VariableLibrary	ZmiennaLibrary.
Dataflow	Przepływ danych.
ApacheAirflowJob	Zadanie ApacheAirflowJob.
WarehouseSnapshot	Migawka magazynu.
DigitalTwinBuilder	A DigitalTwinBuilder.
DigitalTwinBuilderFlow	Przepływ usługi Digital Twin Builder.
MirroredAzureDatabricksCatalog	Dublowany wykaz usługi Azure Databricks.
Map	Mapa.
AnomalyDetector	Wykrywacz anomalii.
UserDataFunction	Funkcja danych użytkownika.
GraphModel	Model programu Graph.
GraphQuerySet	Zestaw zapytań programu Graph.
SnowflakeDatabase	Baza danych Snowflake do przechowywania tabel góry lodowej utworzonych na podstawie konta Snowflake.
OperationsAgent	A OperationsAgent.
CosmosDBDatabase	Baza danych usługi Cosmos DB.
Ontology	Ontologia.
EventSchemaSet	An EventSchemaSet.
DataAgent	A DataAgent.
MirroredCatalog	A MirroredCatalog.
AppBackend	Element AppBackend.
OrgApp	Aplikacja organizacji.
OrgAppAudience	Odbiorcy aplikacji organizacji.
DataBuildToolJob	Obiekt DataBuildToolJob.
AzureDatabricksStorage	Element magazynu oparty na usłudze OneLake dla Azure Databricks.

NewSQLDatabaseCreationPayload

Objekt

Tworzenie ładunku tworzenia elementu bazy danych SQL z obsługiwanymi ustawieniami

Nazwa	Typ	Opis
backupRetentionDays	integer (int32) minimum: 1 maximum: 35	Ustaw okres przechowywania kopii zapasowych w dniach. Minimalna wartość to 1 dni. Maksymalna wartość to 35 dni.
collation	string	Ustaw sortowanie bazy danych SQL.
creationMode	string: New	Tryb tworzenia bazy danych SQL.

PayloadType

Wyliczenie

Typ ładunku części definicji. Dodatkowe typy ładunków mogą być dodawane w czasie.

Wartość	Opis
InlineBase64	Śródliniowa baza 64.

PrincipalType

Wyliczenie

Typ podmiotu zabezpieczeń. Dodatkowe typy podmiotów zabezpieczeń mogą być dodawane w czasie.

Wartość	Opis
User	Podmiot zabezpieczeń jest podmiotem zabezpieczeń Microsoft Entra użytkownika.
ServicePrincipal	Jednostka jest jednostką usługi Microsoft Entra.
Group	Podmiot zabezpieczeń jest grupą zabezpieczeń.
ServicePrincipalProfile	Jednostka jest profilem jednostki usługi.
EntireTenant	Podmiot zabezpieczeń reprezentuje wszystkich użytkowników dzierżawy.

RestoreDeletedDatabaseCreationPayload

Objekt

Uwaga / Notatka

Funkcja PITR z usuniętych baz danych jest obecnie dostępna w wersji zapoznawczej (dowiedz się więcej).

Tworzy element bazy danych SQL, przywracając z przywracalnej usuniętej bazy danych.

Nazwa	Typ	Opis
creationMode	string: RestoreDeletedDatabase	Tryb tworzenia bazy danych SQL.
restorableDeletedDatabaseName	string	Ustaw nazwę przywracanej usuniętej bazy danych do przywrócenia.
restorePointInTime	string (date-time)	Ustaw godzinę przywrócenia źródłowej bazy danych w formacie UTC przy użyciu formatu RRRR-MM-DDTHH:mm:ssZ.

RestoreSQLDatabaseCreationPayload

Objekt

Tworzenie ładunku tworzenia elementu bazy danych SQL przy użyciu przywracania ze źródłowej bazy danych

Nazwa	Typ	Opis
creationMode	string: Restore	Tryb tworzenia bazy danych SQL.
restorePointInTime	string (date-time)	Ustaw godzinę przywrócenia źródłowej bazy danych w formacie UTC przy użyciu formatu RRRR-MM-DDTHH:mm:ssZ.
sourceDatabaseReference	ItemReferenceById	Ustaw odwołanie do źródłowej bazy danych, z których ma zostać przywrócona.

SensitivityLabel

Objekt

Reprezentuje etykietę poufności zastosowaną do elementu.

Nazwa	Typ	Opis
id	string (uuid)	Identyfikator etykiety poufności.

SensitivityLabelApplyStrategy

Wyliczenie

Strategia stosowania etykiety poufności. Wartość domyślna to ApplyOrFail. Dodatkowe typy mogą być dodawane w czasie.

Wartość	Opis
ApplyOrFail	Zastosuj etykietę poufności lub nie powiedzie się operacji, jeśli nie można jej zastosować.
Ignore	Zignoruj etykietę poufności, jeśli nie można jej zastosować i kontynuuj operację bez stosowania etykiety.

SensitivityLabelSettings

Objekt

Ustawienia etykiety poufności.

Nazwa	Typ	Opis
labelId	string (uuid)	Identyfikator etykiety poufności.
sensitivityLabelApplyStrategy	SensitivityLabelApplyStrategy	Strategia stosowania etykiety poufności.

ServicePrincipalDetails

Objekt

Szczegóły dotyczące jednostki usługi. Dotyczy, gdy typ podmiotu zabezpieczeń to ServicePrincipal.

Nazwa	Typ	Opis
aadAppId	string (uuid)	Microsoft Entra AppId jednostki usługi.

ServicePrincipalPrincipal

Objekt

Reprezentuje Microsoft Entra jednostkę usługi.

Nazwa	Typ	Opis
displayName	string	Nazwa wyświetlana podmiotu zabezpieczeń.
id	string (uuid)	Identyfikator podmiotu zabezpieczeń.
servicePrincipalDetails	ServicePrincipalDetails	Szczegóły dotyczące jednostki usługi. Dotyczy, gdy typ podmiotu zabezpieczeń to `ServicePrincipal`.
type	string: ServicePrincipal	Typ podmiotu zabezpieczeń. Dodatkowe typy podmiotów zabezpieczeń mogą być dodawane w czasie.

ServicePrincipalProfileDetails

Objekt

Szczegóły profilu jednostki usługi. Dotyczy, gdy typ podmiotu zabezpieczeń to ServicePrincipalProfile.

Nazwa	Typ	Opis
parentPrincipal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Jednostka nadrzędna profilu jednostki usługi.

ServicePrincipalProfilePrincipal

Objekt

Reprezentuje profil jednostki usługi.

Nazwa	Typ	Opis
displayName	string	Nazwa wyświetlana podmiotu zabezpieczeń.
id	string (uuid)	Identyfikator podmiotu zabezpieczeń.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	Szczegóły profilu jednostki usługi. Dotyczy, gdy typ podmiotu zabezpieczeń to `ServicePrincipalProfile`.
type	string: ServicePrincipalProfile	Typ podmiotu zabezpieczeń. Dodatkowe typy podmiotów zabezpieczeń mogą być dodawane w czasie.

SQLDatabase

Objekt

Obiekt bazy danych SQL.

Nazwa	Typ	Opis
defaultIdentity	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Tożsamość domyślna elementu.
description	string	Opis elementu.
displayName	string	Nazwa wyświetlana elementu.
folderId	string (uuid)	Identyfikator folderu.
id	string (uuid)	Identyfikator elementu.
properties	SQLDatabaseProperties	Właściwości bazy danych SQLDatabase.
sensitivityLabel	SensitivityLabel	Etykieta poufności elementu.
tags	ItemTag[]	Lista zastosowanych tagów.
type	ItemType	Typ elementu.
workspaceId	string (uuid)	Identyfikator obszaru roboczego.

SQLDatabaseDefinition

Objekt

Obiekt definicji publicznej bazy danych SQL. Zapoznaj się z tym artykułem , aby uzyskać więcej informacji na temat struktury definicji bazy danych SQL.

Nazwa	Typ	Opis
format	string	Format definicji bazy danych SQL. Obsługiwany format: `dacpac` i `sqlproj`. Jeśli nie podano żadnego formatu, `dacpac` jest używany.
parts	SQLDatabasePublicDefinitionPart[]	Lista części definicji.

SQLDatabaseProperties

Objekt

Właściwości bazy danych SQL.

Nazwa	Typ	Opis
backupRetentionDays	integer (int32)	Okres przechowywania kopii zapasowej w dniach.
collation	string	Sortowanie bazy danych SQL.
connectionString	string	Connection string bazy danych.
databaseName	string	Nazwa bazy danych.
earliestRestorePoint	string (date-time)	Sygnatura czasowa ISO 8601 dla najwcześniejszego punktu przywracania bazy danych w formacie UTC przy użyciu formatu RRRR-MM-DDTHH:mm:ssZ.
latestRestorePoint	string (date-time)	Znacznik czasu ISO 8601 dla najnowszego punktu przywracania bazy danych w formacie UTC przy użyciu formatu RRRR-MM-DDTHH:mm:ssZ.
serverFqdn	string	W pełni kwalifikowana nazwa domeny serwera (FQDN).

SQLDatabasePublicDefinitionPart

Objekt

Obiekt części definicji bazy danych SQL.

Nazwa	Typ	Opis
path	string	Ścieżka części definicji publicznej bazy danych SQL. Obsługiwane rozszerzenia zawartości bazy danych SQL: `.dacpac` dla `dacpac` formatu; `.sqlproj`, `.sql` dla `sqlproj` formatu.
payload	string	Ładunek części definicji publicznej bazy danych SQL.
payloadType	PayloadType	Typ ładunku.

UserDetails

Objekt

Szczegóły dotyczące podmiotu zabezpieczeń użytkownika. Dotyczy, gdy typ podmiotu zabezpieczeń to User.

Nazwa	Typ	Opis
userPrincipalName	string	Główna nazwa użytkownika.

UserPrincipal

Objekt

Reprezentuje Microsoft Entra podmiot zabezpieczeń użytkownika.

Nazwa	Typ	Opis
displayName	string	Nazwa wyświetlana podmiotu zabezpieczeń.
id	string (uuid)	Identyfikator podmiotu zabezpieczeń.
type	string: User	Typ podmiotu zabezpieczeń. Dodatkowe typy podmiotów zabezpieczeń mogą być dodawane w czasie.
userDetails	UserDetails	Szczegóły dotyczące podmiotu zabezpieczeń użytkownika. Dotyczy, gdy typ podmiotu zabezpieczeń to `User`.