Servers - Import Database

Referens

Tjänst:: SQL Database

API-version:: 2023-08-01

Importerar ett bacpac till en ny databas.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/import?api-version=2023-08-01

URI-parametrar

Name	I	Obligatorisk	Typ	Description
resourceGroupName	path	True	string	Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.
serverName	path	True	string	Namnet på servern.
subscriptionId	path	True	string	Det prenumerations-ID som identifierar en Azure-prenumeration.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Begärandetext

Name	Obligatorisk	Typ	Description
administratorLogin	True	string	Administratörens inloggningsnamn.
administratorLoginPassword	True	string	Administratörens inloggningslösenord.
storageKey	True	string	Lagringsnyckel.
storageKeyType	True	StorageKeyType	Typ av lagringsnyckel.
storageUri	True	string	Lagrings-URI.
authenticationType		string	Autentiseringstyp.
databaseName		string	Namnet på importdatabasen.
edition		string	Utgåva av importdatabasen.
maxSizeBytes		string	Maximal storlek i byte för importdatabasen.
networkIsolation		NetworkIsolationSettings	Valfri resursinformation för att aktivera nätverksisolering för begäran.
serviceObjectiveName		string	Namn på tjänstnivåmål för importdatabasen.

Svar

Name	Typ	Description
200 OK	ImportExportOperationResult	Databasen har importerats.
202 Accepted		Importen av databasen pågår. Sidhuvuden Location: string
Other Status Codes	ErrorResponse	Felsvar: *** 400 MissingImportExportInputParameters – Parametrar för ImportExport-indata saknas. 400 InvalidImportExportInputParameter – import-/exportbegäran misslyckades på grund av en ogiltig indataparameter. 400 PolybaseImportAuthenticationTypeNotSupported – parametern Autentiseringstyp stöder inte PolybaseImport-åtgärden. 400 DatabaseExtensionsInvalidOperationMode – Ogiltig operationMode-parameter för databastillägg. 400 DatabaseExtensionsInvalidStorageKeyType – Lagringsnyckeltypen måste vara "StorageAccessKey". 400 DatabaseExtensionsMissingStorageUri – Lagrings-URI:n får inte vara tom. 400 SQLPasswordSpecifiedWithManagedIdentity – administratorLoginPassword bör inte anges om authenticationType är ManagedIdentity. 400 InvalidSqlAuthType – ImportExport-åtgärden misslyckades eftersom sql-autentiseringstypen är ogiltig 400 BlobAlreadyExist – Åtgärden ImportExport misslyckades eftersom lagringsbloben redan finns 400 InvalidImportExportOperationResourceLocks – Import/Export-begäran är ogiltig på grund av lås på Private Link-resurserna. 400 DatabaseInvalidSkuPropertyCombination – egenskaperna för den begärda sku:n är inkonsekventa. Kontrollera att en giltig kombination har angetts. Mer information finns i https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability. 400 ImportExportJobError – Åtgärden ImportExport har misslyckats. 400 BlockedByOutboundFirewall – De utgående brandväggsreglerna blockerade begäran. 400 InvalidOperationType – Ange en giltig åtgärdstyp. 400 InvalidMaxSizeTierCombination – Den angivna nivån stöder inte den angivna databasens maxstorlek. 400 InvalidTier – Användaren angav en ogiltig nivå. 400 CannotUseReservedDatabaseName – Det går inte att använda reserverat databasnamn i den här åtgärden. 400 InvalidImportExportParameter – Import/Export-begäran misslyckades på grund av en ogiltig indataparameter. 400 InvalidSku – Användaren angav en ogiltig sku. 400 InvalidTierSkuCombination – Den angivna nivån stöder inte den angivna sku:n. 400 InvalidImportExportStorageCredentials – Import/Export-åtgärden misslyckades på grund av ogiltiga autentiseringsuppgifter för lagring 400 InvalidImportExportStorageAuthType – Import/Export-åtgärden misslyckades på grund av en ogiltig lagringsautentiseringstyp 400 InvalidImportExportStorageKeyFormat – Import/Export-åtgärden misslyckades på grund av ogiltigt lagringsnyckelformat 400 LongImportExportStorageUri – import-/exportåtgärden misslyckades på grund av lång lagrings-URI 400 LargeExportDatabaseSize – Exportåtgärden misslyckades eftersom databasen är större än maxstorleken som stöds 400 FeatureDisabledOnSelectedEdition – Användaren försökte använda en funktion som är inaktiverad i den aktuella databasutgåvan. 400 UnSupportedImportExportEdition – ImportExport-åtgärden misslyckades eftersom den riktar in sig på en ogiltig utgåva 400 InvalidImportExportStorageURI – Åtgärden ImportExport misslyckades eftersom lagrings-URI:n är ogiltig 404 DatabaseDoesNotExist – Användaren har angett ett databasnamn som inte finns på den här serverinstansen. 404 ServerNotInSubscription – Den angivna servern finns inte i den angivna prenumerationen. 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen. 404 ResourceNotFound – Ogiltig begäran som anger en resurs som inte finns. 404 ImportExportOperationIdNotFound – Det går inte att hitta åtgärds-ID:t för import eller export. 404 OperationIdNotFound – Åtgärden med ID finns inte. 409 ImportExportOperationInProgress – En import- eller exportåtgärd pågår i databasen. 409 CannotCancelOperation – hanteringsåtgärden är i ett tillstånd som inte kan avbrytas. 409 OperationCancelled – Åtgärden har avbrutits av användaren. 409 Åtgärd avbröts – Det gick inte att slutföra åtgärden på resursen eftersom den avbröts av en annan åtgärd på samma resurs. 429 SubscriptionTooManyCreateUpdateRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyRequests – Begäranden utöver maxbegäranden som kan bearbetas av tillgängliga resurser. 500 OperationTimedOut – Tidsgränsen för åtgärden uppnåddes och återställdes automatiskt. Försök igen. 503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

Name

Typ

Description

200 OK

ImportExportOperationResult

Databasen har importerats.

202 Accepted

Importen av databasen pågår.

Sidhuvuden

Location: string

Other Status Codes

ErrorResponse

Felsvar: ***

400 MissingImportExportInputParameters – Parametrar för ImportExport-indata saknas.
400 InvalidImportExportInputParameter – import-/exportbegäran misslyckades på grund av en ogiltig indataparameter.
400 PolybaseImportAuthenticationTypeNotSupported – parametern Autentiseringstyp stöder inte PolybaseImport-åtgärden.
400 DatabaseExtensionsInvalidOperationMode – Ogiltig operationMode-parameter för databastillägg.
400 DatabaseExtensionsInvalidStorageKeyType – Lagringsnyckeltypen måste vara "StorageAccessKey".
400 DatabaseExtensionsMissingStorageUri – Lagrings-URI:n får inte vara tom.
400 SQLPasswordSpecifiedWithManagedIdentity – administratorLoginPassword bör inte anges om authenticationType är ManagedIdentity.
400 InvalidSqlAuthType – ImportExport-åtgärden misslyckades eftersom sql-autentiseringstypen är ogiltig
400 BlobAlreadyExist – Åtgärden ImportExport misslyckades eftersom lagringsbloben redan finns
400 InvalidImportExportOperationResourceLocks – Import/Export-begäran är ogiltig på grund av lås på Private Link-resurserna.
400 DatabaseInvalidSkuPropertyCombination – egenskaperna för den begärda sku:n är inkonsekventa. Kontrollera att en giltig kombination har angetts. Mer information finns i https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability.
400 ImportExportJobError – Åtgärden ImportExport har misslyckats.
400 BlockedByOutboundFirewall – De utgående brandväggsreglerna blockerade begäran.
400 InvalidOperationType – Ange en giltig åtgärdstyp.
400 InvalidMaxSizeTierCombination – Den angivna nivån stöder inte den angivna databasens maxstorlek.
400 InvalidTier – Användaren angav en ogiltig nivå.
400 CannotUseReservedDatabaseName – Det går inte att använda reserverat databasnamn i den här åtgärden.
400 InvalidImportExportParameter – Import/Export-begäran misslyckades på grund av en ogiltig indataparameter.
400 InvalidSku – Användaren angav en ogiltig sku.
400 InvalidTierSkuCombination – Den angivna nivån stöder inte den angivna sku:n.
400 InvalidImportExportStorageCredentials – Import/Export-åtgärden misslyckades på grund av ogiltiga autentiseringsuppgifter för lagring
400 InvalidImportExportStorageAuthType – Import/Export-åtgärden misslyckades på grund av en ogiltig lagringsautentiseringstyp
400 InvalidImportExportStorageKeyFormat – Import/Export-åtgärden misslyckades på grund av ogiltigt lagringsnyckelformat
400 LongImportExportStorageUri – import-/exportåtgärden misslyckades på grund av lång lagrings-URI
400 LargeExportDatabaseSize – Exportåtgärden misslyckades eftersom databasen är större än maxstorleken som stöds
400 FeatureDisabledOnSelectedEdition – Användaren försökte använda en funktion som är inaktiverad i den aktuella databasutgåvan.
400 UnSupportedImportExportEdition – ImportExport-åtgärden misslyckades eftersom den riktar in sig på en ogiltig utgåva
400 InvalidImportExportStorageURI – Åtgärden ImportExport misslyckades eftersom lagrings-URI:n är ogiltig
404 DatabaseDoesNotExist – Användaren har angett ett databasnamn som inte finns på den här serverinstansen.
404 ServerNotInSubscription – Den angivna servern finns inte i den angivna prenumerationen.
404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen.
404 ResourceNotFound – Ogiltig begäran som anger en resurs som inte finns.
404 ImportExportOperationIdNotFound – Det går inte att hitta åtgärds-ID:t för import eller export.
404 OperationIdNotFound – Åtgärden med ID finns inte.
409 ImportExportOperationInProgress – En import- eller exportåtgärd pågår i databasen.
409 CannotCancelOperation – hanteringsåtgärden är i ett tillstånd som inte kan avbrytas.
409 OperationCancelled – Åtgärden har avbrutits av användaren.
409 Åtgärd avbröts – Det gick inte att slutföra åtgärden på resursen eftersom den avbröts av en annan åtgärd på samma resurs.
429 SubscriptionTooManyCreateUpdateRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.
429 SubscriptionTooManyRequests – Begäranden utöver maxbegäranden som kan bearbetas av tillgängliga resurser.
500 OperationTimedOut – Tidsgränsen för åtgärden uppnåddes och återställdes automatiskt. Försök igen.
503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

Exempel

Imports to a new database, using private link for the SQL server and storage account.

Imports to a new database.

Imports to a new database, using private link for the SQL server and storage account.

Exempelbegäran

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/import?api-version=2023-08-01

{
  "databaseName": "testdb",
  "storageKeyType": "StorageAccessKey",
  "storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==",
  "storageUri": "https://test.blob.core.windows.net/test.bacpac",
  "administratorLogin": "login",
  "administratorLoginPassword": "password",
  "authenticationType": "Sql",
  "networkIsolation": {
    "sqlServerResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr",
    "storageAccountResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Storage/storageAccounts/test-privatelink"
  }
}

Exempelsvar

Statuskod:: 200

{
  "properties": {
    "requestId": "9d9a794a-5cec-4f23-af70-d29511b522a4",
    "requestType": "Import",
    "queuedTime": "2/2/2020 8:33:27 PM",
    "lastModifiedTime": "2/2/2020 8:34:47 PM",
    "blobUri": "https://test.blob.core.windows.net/test.bacpac",
    "serverName": "testsvr.database.windows.net",
    "databaseName": "testdb",
    "status": "Completed"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/importExportOperationResults/9d9a794a-5cec-4f23-af70-d29511b522a4",
  "name": "9d9a794a-5cec-4f23-af70-d29511b522a4",
  "type": "Microsoft.Sql/servers/databases/importExportOperationResults"
}

Statuskod:: 202

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/importExportOperationResults/00000000-0000-0000-0000-000000000000?api-version=2022-08-01

Imports to a new database.

Exempelbegäran

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/import?api-version=2023-08-01

{
  "databaseName": "testdb",
  "storageKeyType": "StorageAccessKey",
  "storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==",
  "storageUri": "https://test.blob.core.windows.net/test.bacpac",
  "administratorLogin": "login",
  "administratorLoginPassword": "password",
  "authenticationType": "Sql"
}

Exempelsvar

Statuskod:: 200

{
  "properties": {
    "requestId": "9d9a794a-5cec-4f23-af70-d29511b522a4",
    "requestType": "Import",
    "queuedTime": "2/2/2020 8:33:27 PM",
    "lastModifiedTime": "2/2/2020 8:34:47 PM",
    "blobUri": "https://test.blob.core.windows.net/test.bacpac",
    "serverName": "testsvr.database.windows.net",
    "databaseName": "testdb",
    "status": "Completed"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/importExportOperationResults/9d9a794a-5cec-4f23-af70-d29511b522a4",
  "name": "9d9a794a-5cec-4f23-af70-d29511b522a4",
  "type": "Microsoft.Sql/servers/databases/importExportOperationResults"
}

Statuskod:: 202

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/importExportOperationResults/00000000-0000-0000-0000-000000000000?api-version=2022-08-01

Definitioner

Name	Description
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
ImportExportOperationResult	En resultatresurs för ImportExport-åtgärden.
ImportNewDatabaseDefinition	Innehåller den information som krävs för att utföra importåtgärden för den nya databasen.
NetworkIsolationSettings	Innehåller DE ARM-resurser som du vill skapa en privat slutpunktsanslutning för.
PrivateEndpointConnectionRequestStatus	Innehåller status för privata slutpunktsanslutningsbegäranden.
StorageKeyType	Typ av lagringsnyckel.

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Objekt

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

ImportExportOperationResult

Objekt

En resultatresurs för ImportExport-åtgärden.

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.blobUri	string	Blob-URI.
properties.databaseName	string	Databasnamn.
properties.errorMessage	string	Felmeddelande.
properties.lastModifiedTime	string	Senast ändrad tid.
properties.privateEndpointConnections	PrivateEndpointConnectionRequestStatus[]	Hämtar status för privata slutpunkter som är associerade med den här begäran.
properties.queuedTime	string	Köad tid.
properties.requestId	string (uuid)	Begärande-ID.
properties.requestType	string	Typ av begäran.
properties.serverName	string	Servernamn.
properties.status	string	Åtgärdsstatus.
type	string	Resurstyp.

ImportNewDatabaseDefinition

Objekt

Innehåller den information som krävs för att utföra importåtgärden för den nya databasen.

Name	Typ	Description
administratorLogin	string	Administratörens inloggningsnamn.
administratorLoginPassword	string	Administratörens inloggningslösenord.
authenticationType	string	Autentiseringstyp.
databaseName	string	Namnet på importdatabasen.
edition	string	Utgåva av importdatabasen.
maxSizeBytes	string	Maximal storlek i byte för importdatabasen.
networkIsolation	NetworkIsolationSettings	Valfri resursinformation för att aktivera nätverksisolering för begäran.
serviceObjectiveName	string	Namn på tjänstnivåmål för importdatabasen.
storageKey	string	Lagringsnyckel.
storageKeyType	StorageKeyType	Typ av lagringsnyckel.
storageUri	string	Lagrings-URI.

NetworkIsolationSettings

Objekt

Innehåller DE ARM-resurser som du vill skapa en privat slutpunktsanslutning för.

Name	Typ	Description
sqlServerResourceId	string (arm-id)	Resurs-ID:t för SQL-servern som är målet för den här begäran. Om den anges skapas en privat slutpunktsanslutning för SQL-servern. Måste matcha servern som är målet för åtgärden.
storageAccountResourceId	string (arm-id)	Resurs-ID:t för lagringskontot som används för att lagra BACPAC-filen. Om det anges skapas en privat slutpunktsanslutning för lagringskontot. Måste matcha lagringskontot som används för parametern StorageUri.

PrivateEndpointConnectionRequestStatus

Objekt

Innehåller status för privata slutpunktsanslutningsbegäranden.

Name	Typ	Description
privateEndpointConnectionName	string	Anslutningsnamnet för den privata slutpunkten.
privateLinkServiceId	string	Resurs-ID som den privata slutpunkten skapas för.
status	string	Status för den här privata slutpunktsanslutningen.

StorageKeyType

Uppräkning

Typ av lagringsnyckel.

Värde	Description
SharedAccessKey
StorageAccessKey

Dela via

Servers - Import Database

URI-parametrar

Begärandetext

Svar

Exempel

Imports to a new database, using private link for the SQL server and storage account.

Exempelbegäran

Exempelsvar

Imports to a new database.

Exempelbegäran

Exempelsvar

Definitioner

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ImportExportOperationResult

ImportNewDatabaseDefinition

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType

Ytterligare resurser