12.7.2 Loading Binary Log Dumps — MySQL Shell 9.2

12.7.2 Загрузка двоичных журналов дампов

В этом разделе описывается util.loadBinlogs. Эта утилита позволяет загружать дамп двоичного журнала из локального или облачного хранилища.

Синтаксис утилиты:

        util.loadBinlogs(Url[, options])

Url: Путь к локальному файлу или облачному хранилищу. Если указанное расположение существует и содержит дамп, созданный этой утилитой, информация о снимке в этом дампе используется в качестве отправной точки для загрузки двоичного журнала.

См. Параметры.

Требования и ограничения

Должны выполняться следующие условия:

Каталог должен содержать дамп, созданный util.dumpBinlogs().
Дамп должен быть совместим с текущей версией MySQL Shell.
Дамп должен быть завершен.
Информация о снимке должна быть непрерывной.
Текущее значение gtid_executed в целевом экземпляре должно полностью содержать значение gtid_executed первого файла двоичного журнала для загрузки (в хронологическом порядке GTID), игнорируя любые дополнительные транзакции на целевом экземпляре

Параметры

ignoreVersion: (boolean) Загрузить дамп, даже если версия целевого экземпляра несовместима с версией исходного экземпляра, из которого были созданы двоичные журналы.

Значение по умолчанию — false.
ignoreGtidGap: (boolean) Загрузить дампы, даже если текущее значение gtid_executed в целевом экземпляре не полностью содержит начальное значение gtid_executed первого файла двоичного журнала для загрузки.

Значение по умолчанию — false.
stopBefore: (string) Останавливает загрузку перед применением указанного события двоичного журнала. Принимает GTID в следующем формате: UUID[:tag]:transaction-id.
stopAfter: (string) Останавливает загрузку после применения указанного события двоичного журнала. Принимает GTID в следующем формате: UUID[:tag]:transaction-id.
dryRun: (boolean) Выводит информацию о том, что будет загружено, но ничего не загружает.

Значение по умолчанию — false.
showProgress: Отображать (true) или скрывать (false) информацию о ходе загрузки. По умолчанию это true, если stdout является терминалом (tty), например, когда MySQL Shell находится в интерактивном режиме, и false в противном случае.

Параметры для службы HeatWave и Oracle Cloud Infrastructure

osBucketName: "string"

Название ведра Oracle Cloud Infrastructure Object Storage, где расположены файлы дампов. По умолчанию используется профиль [DEFAULT] в файле конфигурации Oracle Cloud Infrastructure CLI, расположенном по адресу ~/.oci/config, для подключения к ведру. Можно использовать альтернативный профиль для подключения с помощью параметров ociConfigFile и ociProfile. Инструкции по настройке файла конфигурации CLI см. в Файл конфигурации SDK и CLI.

osNamespace: "string"

Пространство имен Oracle Cloud Infrastructure, в котором расположено ведро Object Storage, имеющее имя osBucketName. Пространство имен для ведра Object Storage отображается на вкладке «Информация о ведре» на странице сведений о ведре в консоли Oracle Cloud Infrastructure или может быть получено с помощью командной строки Oracle Cloud Infrastructure.

ociConfigFile: "string"

Файл конфигурации Oracle Cloud Infrastructure CLI, содержащий профиль для подключения вместо файла в стандартном расположении ~/.oci/config.

ociProfile: "string"

Имя профиля Oracle Cloud Infrastructure, которое используется для подключения вместо профиля [DEFAULT] в файле конфигурации Oracle Cloud Infrastructure CLI, используемом для подключения.

ociAuth: "string"

Метод аутентификации для подключения к Oracle Cloud Infrastructure. Для использования этого параметра необходимо, чтобы osBucketName был настроен с корректным значением.

Доступные варианты:

api_key: Подключения OCI используют файл конфигурации OCI. См. Раздел 4.7.1, «Oracle Cloud Infrastructure Object Storage».

Если osBucketName определен с корректным значением, но ociAuth не определен, api_key используется по умолчанию.
instance_principal: Подключения OCI используют аутентификацию по принципалам экземпляра. См. Аутентификация по принципалам экземпляра.

Этот параметр нельзя использовать, если определены параметры ociConfigFile или ociProfile.
resource_principal: Подключения OCI используют аутентификацию по принципалам ресурсов. См. Аутентификация по принципалам ресурсов.

Этот параметр нельзя использовать, если определены параметры ociConfigFile или ociProfile.
security_token: Подключения OCI используют временный, сгенерированный токен сеанса. См. Аутентификация на основе токена сеанса.

Параметры для S3-совместимых сервисов

MySQL Shell поддерживает загрузку дампов, хранящихся в S3-совместимых ведрах, таких как Amazon Web Services (AWS) S3.

Примечание

MySQL Shell поддерживает конфигурацию AWS S3 в параметрах командной строки, переменных среды и файлах конфигурации. Параметры командной строки имеют приоритет над переменными среды, файлами конфигурации и параметрами по умолчанию.

Информация о требованиях к конфигурации приведена в Разделе 4.7, «Конфигурация облачных служб».

s3BucketName: "string"

Название S3 ведра, где расположены файлы дампов. По умолчанию используется профиль default в файлах конфигурации Amazon Web Services (AWS) CLI config и credentials, расположенных по адресу ~/.aws/, для подключения к S3 ведру. Можно использовать альтернативные конфигурации и учетные данные для подключения с помощью параметров s3ConfigFile и s3CredentialsFile. Инструкции по установке и настройке AWS CLI см. в Начало работы с AWS CLI.

s3CredentialsFile: "string"

Файл учетных данных, содержащий учетные данные пользователя для подключения вместо файла в стандартном расположении ~/.aws/credentials. Как правило, файл учетных данных содержит aws_access_key_id и aws_secret_access_key для подключения.

s3ConfigFile: "string"

Файл конфигурации AWS CLI, содержащий профиль для подключения вместо файла в стандартном расположении ~/.aws/config. Как правило, файл конфигурации содержит регион и тип вывода для подключения.

s3Profile: "string"

Имя профиля s3 CLI для подключения, вместо профиля default в файле конфигурации AWS CLI, используемом для подключения.

s3Region: "string"

Имя региона для подключения.

s3EndpointOverride: "string"

URL конечной точки для использования вместо значения по умолчанию.

При подключении к совместимому с Oracle Cloud Infrastructure API S3, конечная точка имеет следующий формат: https://namespace.compat.objectstorage.region.oraclecloud.com. Замените namespace на имя пространства имен хранилища объектов и region на идентификатор вашего региона. Например, идентификатор региона для региона США Восточный (Эшберн) — us-ashburn-1.

Для пространства имен с именем axaxnpcrorw5 в регионе США Восточный (Эшберн):

https://axaxnpcrorw5.compat.objectstorage.us-ashburn-1.oraclecloud.com.

END_OF_DOCUMENT_MARKER

Параметры для хранения Microsoft Azure Blob Storage

MySQL Shell поддерживает загрузку из хранилища Microsoft Azure Blob Storage.

Примечание

MySQL Shell поддерживает конфигурацию Microsoft Azure Blob Storage в параметрах командной строки, переменных среды и конфигурационных файлах. Параметры командной строки имеют приоритет над переменными среды и конфигурационными файлами.

Дополнительную информацию о требованиях к конфигурации и порядке приоритета типов конфигурации см. в Разделе 4.7 «Конфигурация облачных служб».

azureContainerName: "string"

Обязательно. Имя контейнера Azure, из которого необходимо загрузить дамп. Контейнер должен существовать.

azureConfigFile: "string"

Необязательно. Конфигурационный файл, содержащий параметры подключения к хранилищу вместо файла по умолчанию, например ~/.azure/config. Если этот параметр не определён, используется файл конфигурации по умолчанию.

azureContainerName должен быть определён и не должен быть пустым.

azureStorageAccount: "string"

Необязательно. Имя учетной записи хранилища Azure, используемой для операции.

azureStorageSasToken: "string"

Необязательно. Токен Azure Shared Access Signature (SAS), используемый для аутентификации операции вместо ключа.