Migrating a database from Managed Service for MySQL® to Yandex Object Storage
With Data Transfer, you can transfer data from a Managed Service for MySQL® source cluster to Yandex Object Storage object storage.
To transfer data:
If you no longer need the resources you created, delete them.
Required paid resources
The support cost for this solution includes:
- Managed Service for MySQL® cluster fee: using computing resources allocated to hosts and disk space (see Managed Service for MySQL® pricing).
- Fee for using public IP addresses if public access is enabled for cluster hosts (see Virtual Private Cloud pricing).
- Fee for an Object Storage bucket: data storage and data operations (see Object Storage pricing).
- Fee per transfer: Based on computational resource usage and the number of data rows transferred (see Data Transfer pricing).
Getting started
Set up the infrastructure:
- Create a Managed Service for MySQL® source cluster with any suitable configuration.
- Create a bucket in Yandex Object Storage.
-
If you do not have Terraform yet, install it.
-
Get the authentication credentials. You can add them to environment variables or specify them later in the provider configuration file.
-
Configure and initialize a provider. There is no need to create a provider configuration file manually, you can download it
. -
Place the configuration file in a separate working directory and specify the parameter values. If you did not add the authentication credentials to environment variables, specify them in the configuration file.
-
Download the data-transfer-mmy-objs.tf
configuration file to the same working directory.This file describes:
- Network.
- Subnet.
- Security group and the rule permitting access to the Managed Service for MySQL® cluster.
- Managed Service for MySQL® source cluster.
- Service account with the
editor,storage.editor, andstorage.uploaderroles. - Object Storage bucket.
- Source endpoint.
- Transfer.
-
Specify the following in
data-transfer-mmy-objs.tf:-
folder_id: ID of the folder to host new resources. -
sa_name: Name of the service account for creating a bucket and for use in the target endpoint. -
bucket_name: Object Storage bucket name. -
The Managed Service for MySQL® source cluster parameters that will be used as the source endpoint parameters:
source_mysql_version: MySQL® version.source_db_name: Database name.source_userandsource_password: Database owner username and password.
-
transfer_enabled: Set0to ensure that no transfer is created before creating a target endpoint manually.
-
-
Validate your Terraform configuration files using this command:
terraform validateTerraform will display any configuration errors detected in your files.
-
Create the required infrastructure:
-
Run this command to view the planned changes:
terraform planIf you described the configuration correctly, the terminal will display a list of the resources to update and their parameters. This is a verification step that does not apply changes to your resources.
-
If everything looks correct, apply the changes:
-
Run this command:
terraform apply -
Confirm updating the resources.
-
Wait for the operation to complete.
-
All the required resources will be created in the specified folder. You can check resource availability and their settings in the management console
. -
Prepare the source cluster
-
If you created the infrastructure manually, you must now prepare your source cluster.
-
Add test data to the database. As an example, we'll use a table with information transmitted by car sensors.
Create a table:
CREATE TABLE measurements ( device_id varchar(200) NOT NULL, datetime timestamp NOT NULL, latitude real NOT NULL, longitude real NOT NULL, altitude real NOT NULL, speed real NOT NULL, battery_voltage real, cabin_temperature real NOT NULL, fuel_level real, PRIMARY KEY (device_id) );Populate the table with data:
INSERT INTO measurements VALUES ('iv9a94th6rzt********', '2022-06-05 17:27:00', 55.70329032, 37.65472196, 427.5, 0, 23.5, 17, NULL), ('rhibbh3y08qm********', '2022-06-06 09:49:54', 55.71294467, 37.66542005, 429.13, 55.5, NULL, 18, 32);
Set up and activate the transfer
-
-
Database type:
Object Storage. -
Endpoint settings:
-
Connection settings:
-
Bucket: Enter the name of the Object Storage bucket.
-
Service account: Select or create a service account with the
storage.uploaderrole.
-
-
Folder name:
measurements.
-
-
-
Create a source endpoint and transfer:
ManuallyTerraform-
-
Database type:
MySQL. -
Endpoint parameters:
-
Connection settings:
-
Connection type:
Managed Service for MySQL cluster.Select your source cluster from the list and specify its connection settings.
-
-
(Optional) Included tables, Excluded tables: Specify regular expressions for tables both subject and not subject to transfer.
-
-
-
Create the Snapshot type transfer and configure it to use the previously created endpoints.
-
Activate the transfer.
-
In the
data-transfer-mmy-objs.tffile, specify these variables:target_endpoint_id: ID of the target endpoint.transfer_enabled: Set to1to create a transfer.- (Optional)
include_tables_regex,exclude_tables_regex: Regular expressions for tables both subject and not subject to transfer.
-
Validate your Terraform configuration files using this command:
terraform validateTerraform will display any configuration errors detected in your files.
-
Create the required infrastructure:
-
Run this command to view the planned changes:
terraform planIf you described the configuration correctly, the terminal will display a list of the resources to update and their parameters. This is a verification step that does not apply changes to your resources.
-
If everything looks correct, apply the changes:
-
Run this command:
terraform apply -
Confirm updating the resources.
-
Wait for the operation to complete.
-
The transfer will activate automatically upon creation.
-
-
Test your transfer
-
Wait for the transfer status to change to Completed.
-
Make sure the data has been moved from the Managed Service for MySQL® source cluster to the Object Storage bucket:
- In the management console
, select the folder where the bucket is located. - In the list of services, select Object Storage.
- Select the bucket from the list.
- Navigate to the Objects tab.
- Make sure that the Object Storage bucket contains the
measurementsdirectory with the<source_cluster_database_name>_measurementsobject with test data.
- In the management console
Delete the resources you created
Note
Before deleting the resources, deactivate the transfer.
Some resources incur charges. To avoid unnecessary charges, delete the resources you no longer need:
Delete other resources using the method matching their creation method:
-
If you created a service account when creating the target endpoint, delete it.
-
In the terminal window, go to the directory containing the infrastructure plan.
Warning
Make sure the directory has no Terraform manifests with the resources you want to keep. Terraform deletes all resources that were created using the manifests in the current directory.
-
Delete resources:
-
Run this command:
terraform destroy -
Confirm deleting the resources and wait for the operation to complete.
All the resources described in the Terraform manifests will be deleted.
-