12.7.1 Dumping Binary Logs — MySQL Shell 9.2

12.7.1 Выгрузка бинарных логов

В этом разделе описывается util.dumpBinlogs. Эта утилита выгружает бинарные логи, созданные с определенного момента, в указанную локальную или удалённую директорию. Начальная точка может быть определена автоматически из предыдущей выгрузки, либо повторным использованием той же выходной директории, либо с помощью опции since, либо явно указанным файлом бинарного лога и позицией в startFrom.

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

        util.dumpBinlogs(outputUrl[, options])

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

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

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

Источный экземпляр должен иметь включённую запись бинарного лога.
должен быть установлен на значение, отличное от OFF или OFF_PERMISSIVE.
Если исходный экземпляр был запущен с или , будет выведено сообщение.

Если другая выгрузка используется в качестве начальной точки для выгрузки бинарного лога, возникает исключение, если выполняется любое из следующих условий:

Выгрузка неполная.
Выгрузка была создана для экземпляра, отличного от текущего исходного экземпляра, и они не являются частью одного кластера InnoDB, или текущий исходный экземпляр не является онлайн-членом этого кластера InnoDB.
Информация о снимке выгрузки новее, чем текущий исходный экземпляр.
Первый файл бинарного лога для выгрузки не существует или gtid_purged содержит транзакции, которые должны быть выгружены.
Выгрузка была создана для экземпляра с разными версиями major.minor, чем у текущего исходного экземпляра.

Параметры

since: (строка) путь или URL до локальной или удалённой директории, содержащей выгрузку, созданную util.dumpInstance() или util.dumpBinlogs(). Выгрузка должна быть полной, создана MySQL Shell 9.2.0 или более поздней версии, и согласованной. Если ocimds:true, или любые из параметров совместимости были использованы, возникает исключение.

Примечание

Этот параметр не может быть использован с startFrom.
startFrom: (строка) позиция файла бинарного лога для начала выгрузки. Это значение использует формат binary-log-file[:binary-log-file-position]. Где binary-log-file - имя бинарного лога, а binary-log-file-position - целое беззнаковое число, определяющее позицию в этом файле.

Примечание

Этот параметр не может быть использован с since.
ignoreDdlChanges: (булево) выводит предупреждение вместо исключения, если ocimds:true или любые параметры совместимости были использованы в выгрузке.

Значение по умолчанию — false.
threads: (целое) количество дополнительных потоков для использования при выгрузке бинарных логов.

Значение по умолчанию — 4.
dryRun: (булево) выводит информацию о том, что должно быть выгружено, но ничего не выгружает.

Значение по умолчанию — false.
compression: "string;level=n" Тип сжатия и уровень сжатия для использования при создании файлов выгрузки. Доступны следующие варианты сжатия:
- none: Сжатие не применяется.
- gzip: Использует библиотеку сжатия gzip. Уровень сжатия может быть установлен от 0 до 9. Уровень сжатия по умолчанию — 1.
- zstd: По умолчанию. Использует библиотеку сжатия zstd. Уровень сжатия может быть установлен от 1 до 22. Уровень сжатия по умолчанию — 1.
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 используют временный, сгенерированный токен сессии. См. Аутентификация с использованием токена сессии.

END_OF_DOCUMENT_MARKER

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

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

Примечание

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

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

s3BucketName: "string"

Имя хранилища S3, в которое будет производиться экспорт. По умолчанию используется профиль default из файлов 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/config. Обычно конфигурационный файл содержит регион и тип вывода для подключения.

s3Profile: "string"

Имя профиля s3 CLI-профиля для подключения вместо профиля default.

s3Region: "string"

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

s3EndpointOverride: "string"

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

При подключении к API совместимости Oracle Cloud Infrastructure S3 конечная точка имеет следующий формат: https://namespace.compat.objectstorage.region.oraclecloud.com. Замените namespace на имя пространства имен Object Storage и region на идентификатор вашего региона. Например, идентификатор региона для региона US East (Ashburn) — us-ashburn-1.

Для пространства имен axaxnpcrorw5 в регионе US East (Ashburn):

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

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

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) для аутентификации операции вместо ключа.