Поделиться через

Краткое руководство: импорт BACPAC-файла в базу данных в Azure SQL Database или Azure SQL Managed Instance

Применимо к:Azure SQL DatabaseAzure SQL Managed Instance

Базу данных SQL Server можно импортировать в Azure SQL Database или SQL Managed Instance с помощью файла .bacpac. Вы можете импортировать данные из BACPAC-файла, который хранится в объектном хранилище Azure (только для стандартного хранилища), или из локального хранилища в локальной среде. Чтобы увеличить скорость импорта, предоставив больше и более быстрых ресурсов, масштабируйте базу данных до более высокого уровня обслуживания и размера вычисления во время процесса импорта. После завершения импорта эти значения можно уменьшить.

Примечание.

Импорт или экспорт Azure SQL Database с помощью частного соединения находится на стадии предварительного просмотра.

Использование портала Azure

Просмотрите это видео, чтобы узнать, как импортировать из BACPAC-файла на портале Azure или продолжить чтение:

  • Портал Azureonly поддерживает создание одной базы данных в Azure SQL Database и only из BACPAC-файла, хранящегося в хранилище BLOB-объектов Azure.
  • Чтобы перенести базу данных в Azure SQL Managed Instance из BACPAC-файла, используйте SQL Server Management Studio или служебную программу командной строки > SqlPackage. Портал Azure и Azure PowerShell в настоящее время не поддерживаются.

Предупреждение

BACPAC-файлы размером более 150 ГБ, созданные из SqlPackage, могут не импортироваться с портала Azure или Azure PowerShell с сообщением об ошибке, которое указывает File contains corrupted data. Это результат известной проблемы, и решением является использование SqlPackage служебной программы командной строки для импорта BACPAC-файла. Дополнительные сведения см. в разделе SqlPackage и список проблем.

Примечание.

Компьютеры, обрабатываемые запросы на импорт и экспорт, отправленные через портал Azure или PowerShell, должны хранить BACPAC-файл, а также временные файлы, созданные Data-Tier Application Framework (DacFX). Требуемое дисковое пространство может быть существенно разным для баз данных одного размера и в три раза превышать размер самой базы данных. Компьютеры, на которых выполняется запрос на импорт или экспорт, располагают только 450 ГБ пространства на локальном диске. В результате некоторые запросы могут завершиться ошибкой There is not enough space on the disk. В этом случае обходной путь — запустить служебную программу командной строки SqlPackage на компьютере с достаточным объемом места на локальном диске. Мы рекомендуем использовать служебную программу командной строки SqlPackage для импорта и экспорта баз данных размером более 150 ГБ, чтобы избежать этой проблемы.

  1. Чтобы импортировать из BACPAC-файла в новую базу данных с помощью портала Azure, откройте соответствующую страницу сервера, а затем на панели инструментов выберите Import database.

    Снимок экрана портала Azure, страница обзора логического сервера с выбранным импортом базы данных.

  2. Выберите "Выбрать резервную копию". Выберите учетную запись хранения, в которой размещена база данных, а затем выберите BACPAC-файл, из которого необходимо импортировать.

  3. Укажите новый размер базы данных (обычно совпадает с источником) и укажите конечные SQL Server учетные данные. Список возможных значений для новой базы данных в Azure SQL Database см. в разделе Create Database.

    Снимок экрана портала Azure, страница импорта базы данных.

  4. Нажмите ОК.

  5. Чтобы отслеживать ход выполнения импорта, откройте страницу сервера базы данных. В разделе Параметры выберите Журнал импорта и экспорта. При успешном выполнении импорта отображается состояние Завершено.

    Скриншот портала Azure, страница обзора сервера, показывающая статус импорта базы данных.

  6. Выберите Базы данных SQL, чтобы проверить активность базы данных на сервере, и убедитесь, что для новой базы данных задано состояние В сети.

Импорт с аутентификацией с помощью управляемого удостоверения (предварительная версия)

Azure SQL Database поддерживает импорт файла BACPAC с использованием аутентификации с управляемым удостоверением. Этот параметр включает полностью операции импорта без учетных данных и рекомендуется для сред, которые отключают проверку подлинности SQL или применяют проверку подлинности только Microsoft Entra.

Вы можете импортировать базу данных в новую базу данных или в существующую пустую базу данных.

Подробное руководство см. в разделе "Использование управляемого удостоверения" с импортом и экспортом (предварительная версия).

Чтобы импортировать BACPAC-файл с помощью аутентификации управляемой идентичности, требуется следующая конфигурация:

  • Управляемое удостоверение, назначенное пользователем (UAMI), назначено логическому серверу для базы данных Azure SQL.
  • Сервер имеет управляемое удостоверение, настроено как администратор Microsoft Entra.
  • Управляемое удостоверение назначается роли Storage Blob Data Reader учетной записи исходного экземпляра Azure Storage. Это управляемое удостоверение может быть таким же, как назначенное серверу, или другим.
  • Логический сервер, управляемое удостоверение и учетная запись хранения находятся в одном арендаторе Microsoft Entra.

Следующие сценарии не поддерживаются.

  • Операции импорта между клиентами.
  • Управляемое удостоверение, назначенное только на уровне базы данных.

Примечание.

Импорт с проверкой подлинности управляемого удостоверения в настоящий момент находится в предварительной версии и доступен только для Azure SQL Database.

Использование SqlPackage

Сведения о импорте базы данных SQL Server с помощью служебной программы командной строки SqlPackage см. в разделе import parameters and properties. Вы можете скачать последнюю версию SqlPackage для Windows, macOS или Linux.

Для масштабирования и производительности рекомендуется использовать SqlPackage в большинстве рабочих сред, а не на портале Azure. Блог консультационной группы по клиентам SQL Server о миграции с помощью файлов BACPAC см. в статье о миграции из SQL Server в базу данных Azure SQL с использованием файлов BACPAC.

Модель подготовки на основе DTU поддерживает выбор значений максимального размера базы данных для каждого уровня. При импорте базы данных используйте одно из этих поддерживаемых значений.

Следующая команда SqlPackage импортирует AdventureWorks2008R2 базу данных из локального хранилища в логический SQL-сервер с именем mynewserver20170403. Создается новая база данных, названная myMigratedDatabase, с уровнем Premium и целевым показателем P6. Измените эти значения соответствующим образом для вашей среды.

SqlPackage /a:import /tcs:"Data Source=<serverName>.database.windows.net;Initial Catalog=<migratedDatabase>;User Id=<userId>;Password=<password>" /sf:AdventureWorks2008R2.bacpac /p:DatabaseEdition=Premium /p:DatabaseServiceObjective=P6

Внимание

Чтобы подключиться к Azure SQL Database за корпоративным брандмауэром, брандмауэр должен иметь порт 1433. Чтобы подключиться к SQL Managed Instance, необходимо установить подключение 'точка-сайт' или подключение с использованием 'express route'.

Как альтернатива имени пользователя и паролю, можно использовать Microsoft Entra ID (ранее называвшийся Azure Active Directory). В настоящее время служба импорта и экспорта не поддерживает проверку подлинности Microsoft Entra ID при необходимости многофакторной проверки подлинности. Замените параметры имени пользователя и пароля для /ua:true и /tid:"yourdomain.onmicrosoft.com". В этом примере показано, как импортировать базу данных с помощью SqlPackage с проверкой подлинности Microsoft Entra:

SqlPackage /a:Import /sf:testExport.bacpac /tdn:NewDacFX /tsn:apptestserver.database.windows.net /ua:True /tid:"apptest.onmicrosoft.com"

Visual Studio Code

Расширение MSSQL для Visual Studio Code — это бесплатное расширение с открытым кодом, доступное для Windows, macOS и Linux. Расширение включает опыт работы с приложениями уровня данных (предварительная версия) для операций SqlPackage, включая экспорт и импорт. Дополнительные сведения об установке и использовании расширения см. в расширении MSSQL для Visual Studio Code.

С помощью PowerShell

Примечание.

Azure SQL Managed Instance в настоящее время не поддерживает импорт базы данных из BACPAC-файла в базу данных экземпляра с помощью Azure PowerShell. Чтобы импортировать в управляемый экземпляр SQL, используйте SQL Server Management Studio или SQLPackage.

Примечание.

Компьютеры, обрабатывая запросы на импорт и экспорт, отправленные через портал или PowerShell, должны хранить BACPAC-файл, а также временные файлы, созданные Data-Tier Application Framework (DacFX). Требуемое место на диске значительно различается для баз данных одинакового размера и может составлять до трех размеров базы данных. Компьютеры, на которых выполняется запрос на импорт или экспорт, располагают только 450 ГБ пространства на локальном диске. В результате некоторые запросы могут завершиться ошибкой: There is not enough space on the disk В этом случае обходным решением является запуск SqlPackage на компьютере с достаточным объемом локального дискового пространства. При импорте или экспорте баз данных, размер которых превышает 150 ГБ, используйте SqlPackage, чтобы избежать этой проблемы.

Внимание

Модуль PowerShell Azure Resource Manager (AzureRM) был объявлен устаревшим 29 февраля 2024 года. Все будущие разработки должны использовать модуль Az.Sql. Пользователям рекомендуется выполнить миграцию из AzureRM в модуль Az PowerShell, чтобы обеспечить постоянную поддержку и обновления. Модуль AzureRM больше не поддерживается и не обновляется. Аргументы команд в модуле Az PowerShell и в модулях AzureRM существенно идентичны. Дополнительные сведения о совместимости см. в статье Знакомство с новым модулем Az PowerShell.

Используйте командлет New-AzSqlDatabaseImport для отправки запроса на импорт базы данных в Azure. В зависимости от размера базы данных импорт может занять некоторое время. Модель подготовки на основе DTU поддерживает выбор значений максимального размера базы данных для каждого уровня. При импорте базы данных используйте одно из этих поддерживаемых значений.

$importRequest = New-AzSqlDatabaseImport -ResourceGroupName "<resourceGroupName>" `
    -ServerName "<serverName>" -DatabaseName "<databaseName>" `
    -DatabaseMaxSizeBytes "<databaseSizeInBytes>" -StorageKeyType "StorageAccessKey" `
    -StorageKey $(Get-AzStorageAccountKey `
        -ResourceGroupName "<resourceGroupName>" -StorageAccountName "<storageAccountName>").Value[0] `
        -StorageUri "https://myStorageAccount.blob.core.windows.net/importsample/sample.bacpac" `
        -Edition "Premium" -ServiceObjectiveName "P6" `
        -AdministratorLogin "<userId>" `
        -AdministratorLoginPassword $(ConvertTo-SecureString -String "<password>" -AsPlainText -Force)

Чтобы проверить ход выполнения импорта, используйте командлет Get-AzSqlDatabaseImportExportStatus. Если выполнить его немедленно после запроса, то обычно возвращается сообщение Status: InProgress. Импорт считается завершенным, когда вы увидите Status: Succeeded.

$importStatus = Get-AzSqlDatabaseImportExportStatus -OperationStatusLink $importRequest.OperationStatusLink

[Console]::Write("Importing")
while ($importStatus.Status -eq "InProgress") {
    $importStatus = Get-AzSqlDatabaseImportExportStatus -OperationStatusLink $importRequest.OperationStatusLink
    [Console]::Write(".")
    Start-Sleep -s 10
}

[Console]::WriteLine("")
$importStatus

Совет

Другой пример скрипта см. в статье "Использование PowerShell для импорта BACPAC-файла в базу данных SQL".

Отмена запроса на импорт

Используйте API управления базой данных - отмены или команду Stop-AzSqlDatabaseActivity PowerShell, как показано в следующем примере:

Stop-AzSqlDatabaseActivity -ResourceGroupName $ResourceGroupName -ServerName $ServerName -DatabaseName $DatabaseName -OperationId $Operation.OperationId

Разрешения, необходимые для отмены импорта

Чтобы отменить операцию импорта, необходимо быть членом одной из следующих ролей:

Уровень совместимости новой базы данных

  • Уровень совместимости импортированной базы данных основан на уровне совместимости базы данных-источника.

  • После импорта базы данных можно использовать базу данных на текущем уровне совместимости или на более высоком уровне. Дополнительные сведения о последствиях и вариантах работы базы данных на определенном уровне совместимости см. в разделе ALTER DATABASE. Сведения о других параметрах уровня базы данных, связанных с уровнями совместимости, см. в разделе ALTER DATABASE SCOPED CONFIGURATION.

Ограничения

  • Импорт в базу данных в эластичном пуле не поддерживается через портал Azure, Azure PowerShell или Azure CLI. Вместо этого создайте базу данных в эластичном пуле и используйте sqlPackage Importили импортируйте данные с помощью любого метода в одну базу данных, а затем переместите базу данных в эластичном пуле.
  • Импорт службы экспорта не работает, если параметр "Разрешить доступ к службам Azure" имеет значение OFF. Однако вы можете обойти проблему, выполнив sqlPackage вручную из виртуальной машины Azure или выполняя экспорт непосредственно в коде с помощью API DacFx.
  • Импорт не поддерживает указание избыточности резервного хранилища при создании новой базы данных, которая создается с использованием избыточности по умолчанию для гео-резервного хранилища. Чтобы обойтись, сначала создайте пустую базу данных с требуемой избыточностью хранилища резервных копий с помощью портала Azure или PowerShell, а затем импортируйте BACPAC в эту пустую базу данных.
  • Хранилище за брандмауэром сейчас не поддерживается.
  • Во время импорта не создавайте базу данных с тем же именем. Процесс импорта создает новую базу данных указанного имени.
  • В настоящее время служба импорта и экспорта не поддерживает проверку подлинности Microsoft Entra ID при необходимости многофакторной проверки подлинности.
  • Службы Import\Export поддерживают только проверку подлинности SQL и Microsoft Entra ID. Импорт\Экспорт несовместим с регистрацией приложения Microsoft Identity.

Дополнительные средства

Вы также можете использовать этих мастеров.

Связанный контент

  • Last updated on