Configure a source MySQL data source

When you synchronize data in a MySQL database to MaxCompute, you can refer to the operations in this topic to prepare configurations such as network environments and whitelists for data sources. The MySQL database is the source data source and MaxCompute is the destination data source.

Prerequisites

Before you configure data sources, make sure that the following operations are performed:

Prepare data sources: A source MySQL data source and a destination MaxCompute data source are created.
Plan and prepare resources: An exclusive resource group for data integration is purchased and configured. For more information, see Plan and configure resources.
Evaluate and plan the network environment: Before you perform data integration, connect data sources to exclusive resource groups for data integration based on your business requirements. After data sources and exclusive resource groups for data integration are connected, you can refer to the operations in this topic to configure access settings such as vSwitches and whitelists.
- If data sources and exclusive resource groups for data integration reside in the same region and virtual private cloud (VPC), they are automatically connected.
- If data sources and exclusive resource groups for data integration reside in different network environments, you must connect data sources and resource groups by using methods such as a VPN gateway.
Prepare the MaxCompute client: The MaxCompute client is installed. You need to use the MaxCompute client to configure attributes for the destination MaxCompute data source. For more information, see Install and configure the MaxCompute client.

Background information

Before you synchronize data from source data sources to destination data sources, make sure that data sources and exclusive resource groups for data integration are connected. You must also make sure that the exclusive resource groups for data integration can be used to access the data sources.

Configure whitelists for data sources
If data sources and exclusive resource groups for data integration reside in the same VPC, you need to add the CIDR block of the exclusive resource group to the whitelists of data sources. This ensures that the exclusive resource group for data integration can be used to access data sources.
Create an account and authorize the account
You must create an account that can be used to access data sources, read data from the source data source, and write data to the destination data source in the data integration process.
Enable the binary logging feature
If the source data source is a MySQL database, you must enable the binary logging feature. Binary logs record changes to all table schemas and modifications on table data. You can execute statements such as CREATE and ALTER to perform operations on table schemas. You can execute statements such as INSERT, UPDATE, and DELETE to perform operations on table data. You can use binary logs to view the change history of the database, back up incremental data and restore data in the database, and replicate data from the primary database to secondary databases.
Formats of binary logs:
- Statement: SQL statement-based replication. Binary logs in this format record the SQL statements that are executed to modify data entries.
- Row: row-based replication. Binary logs in this format record only modification details about data entries in rows.
- Mixed: replication in mixed mode. This mode combines the statement and row formats. In most cases, binary logs in the statement format are used to record the SQL statements that are executed to modify data entries, such as functions. If data replication from the primary database to secondary databases cannot be implemented by using binary logs in this format, switch to the row format. MySQL determines which format to use based on each SQL statement that is executed.

Configure a whitelist for a MySQL database.
Add the CIDR block of the VPC where the exclusive resource group resides to the whitelist of the MySQL database.
1. View and record the EIP and CIDR block of the exclusive resource group.
2. Add the EIP and CIDR block of the exclusive resource group to the whitelist of the MySQL database.
Create an account and grant the required permissions to the account.
You must create an account to log on to the MySQL database. You must grant the SELECT, REPLICATION SLAVE, and REPLICATION CLIENT permissions to the account.
1. Create an account.
  For more information, see Create an account to access a MySQL database.
2. Grant permissions to the account.
  You can run the following command to grant permissions to the account. Alternatively, you can grant the SUPER permission to the account. Replace Account for data synchronization with the created account when you execute the specific statement.
```
-- CREATE USER 'Account for data synchronization'@'%' IDENTIFIED BY 'Password'; // Create an account that is used to synchronize data and set a password so that you can use the account and password to access the database from a host. % indicates a host.
GRANT SELECT, REPLICATION SLAVE, REPLICATION CLIENT ON *. * TO 'Account for data synchronization'@'%'; // Grant the SELECT, REPLICATION SLAVE, and REPLICATION CLIENT permissions to the account.
```
  *.* indicates that the synchronization account is granted the preceding permissions on all tables in all databases. You can also grant the preceding permissions on specified tables in the destination database to the synchronization account. For example, to grant the account the preceding permissions on the user table in the test database, execute the following statement: GRANT SELECT, REPLICATION SLAVE, REPLICATION CLIENT ON test.user TO 'Account for data synchronization'@'%';.
3. Enable the binary logging feature for the MySQL database.
  Perform the following steps to check whether the binary logging feature is enabled and to query the format of binary logs:
  - Execute the following statement to check whether the binary logging feature is enabled:
```
show variables like "log_bin";
```
    If ON is displayed in the returned result, the binary logging feature is enabled.
  - If you use a secondary database to synchronize data, execute the following statement to check whether the binary logging feature is enabled:
```
show variables like "log_slave_updates";
```
    If ON is displayed in the returned result, the binary logging feature is enabled for the secondary database.
  If the returned result is different from the preceding result, follow the instructions described in the MySQL documentation to enable the binary logging feature.
  Execute the following statement to view the format of binary logs:
```
show variables like "binlog_format";
```
  Returned result:
  - ROW: The format of binary logs is row.
  - STATEMENT: The format of binary logs is statement.
  - MIXED: The format of binary logs is mixed.

Configure the destination MaxCompute data source

Log on to the MaxCompute client by using the account of a project owner.
For more information, see Install and configure the MaxCompute client.
Enable the atomicity, consistency, isolation, durability (ACID) property for the MaxCompute project.
Run the following command on the MaxCompute client:
```
setproject odps.sql.acid.table.enable=true;
```
Optional:Enable the MaxCompute V2.0 data type edition.
If you need to use the TIMESTAMP data type in MaxCompute V2.0, run the following command to enable the MaxCompute V2.0 data type edition:
```
setproject odps.sql.type.system.odps2=true;
```
Create an Alibaba Cloud account.
This account is used to add a data source and access MaxCompute for data synchronization. For more information about how to create an Alibaba Cloud account, see Create an Alibaba Cloud account.
After the Alibaba Cloud account is created, you can record the AccessKey ID and AccessKey secret of the account for future use.

What to do next

After data sources are configured, the source data source, destination data source, and exclusive resource group for data integration are connected. Then, the exclusive resource group for data integration can be used to access data sources. You can add the source data source and destination data source to DataWorks, and associate them with a data synchronization solution when you create the solution.

For more information about how to add a data source, see Add a data source.