You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Nov 19, 2024. It is now read-only.
The `mysql` service provides persistent data storage based on [MariaDB](https://mariadb.com/) versions 10.2-10.4, supporting the [XtraDB](https://www.percona.com/software/mysql-database/percona-server/xtradb) storage engine and reimplemented features from MySQL 5.6 and 5.7.
11
+
The `mysql` service provides persistent data storage based on [MariaDB](https://mariadb.com/) versions 10.2 to 10.4, supporting the [XtraDB](https://www.percona.com/software/mysql-database/percona-server/xtradb) storage engine and reimplemented features from MySQL 5.6 and 5.7.
12
12
13
13
{% include install/maria-db.md %}
14
14
15
15
{:.bs-callout-warning}
16
16
Be careful when upgrading MariaDB from version 10.1 to 10.2.
17
-
MariaDB 10.1 is the last version that support XtraDB as the storage engine. Version 10.2 uses InnoDB for the storage engine. Once you upgrade from 10.1 to 10.2, you cannot rollback the change. {{site.data.var.ee}} supports both storage engines; however, you must check extensions and other systems used by your project to make sure they are compatible with MariaDB 10.2. Read about this [backwards incompatible change](https://mariadb.com/kb/en/upgrading-from-mariadb-101-to-mariadb-102/#incompatible-changes-between-101-and-102).
17
+
MariaDB 10.1 is the last version that supports XtraDB as the storage engine. Version 10.2 uses InnoDB for the storage engine. Once you upgrade from 10.1 to 10.2, you cannot rollback the change. {{site.data.var.ee}} supports both storage engines; however, you must check extensions and other systems used by your project to make sure they are compatible with MariaDB 10.2. Read about this [backwards incompatible change](https://mariadb.com/kb/en/upgrading-from-mariadb-101-to-mariadb-102/#incompatible-changes-between-101-and-102).
18
18
19
19
{% include cloud/service-config-integration-starter.md %}
20
20
@@ -50,12 +50,12 @@ MariaDB 10.1 is the last version that support XtraDB as the storage engine. Vers
50
50
51
51
## Set up multiple database users
52
52
53
-
Optionally, you can set up multiple databases as well as multiple users with different permissions.
53
+
Optionally, you can set up multiple databases and multiple users with different permissions.
54
54
55
-
An _endpoint_ is a set of credentials (or users) with specific privileges. By default, there is one endpoint named `mysql` that has administrator access to all defined databases. To set up multiple database users, you must define multiple endpoints in the services.yaml file and declare the relationships in the .magento.app.yaml file.
55
+
An _endpoint_ is a set of credentials (or users) with specific privileges. By default, there is one endpoint named `mysql` that has administrator access to all defined databases. To set up multiple database users, you must define multiple endpoints in the services.yaml file and declare the relationships in the `.magento.app.yaml` file. For Pro Staging and Production environments, submit a Support ticket to request the additional user.
56
56
57
57
{:.bs-callout-warning}
58
-
You cannot use multiple _databases_ with {{site.data.var.ee}} at this time, but you **can** create multiple endpoints to restrict access to the `main` database.
58
+
You cannot use multiple _databases_ with {{site.data.var.ee}}, but you **can** create multiple endpoints to restrict access to the `main` database.
59
59
60
60
Use a nested array to define the endpoints for specific user access. Each endpoint can designate access to one or more schemas (databases) and different levels of permission on each.
61
61
@@ -87,13 +87,13 @@ mysql:
87
87
main: rw
88
88
```
89
89
90
-
In the preceding example, the `admin` endpoint provides admin-level access to the `main` database, the `reporter` endpoint provides read-only access, and the `importer` endpoint provides read-write access. This means that:
90
+
In the preceding example, the `admin` endpoint provides admin-level access to the `main` database, the `reporter` endpoint provides read-only access, and the `importer` endpoint provides read-write access, which means:
91
91
92
92
- The `admin` user has full control of the database.
93
93
- The `reporter` user has SELECT privileges only.
94
94
- The `importer` user has SELECT, INSERT, UPDATE, and DELETE privileges.
95
95
96
-
You must add the endpoints defined in the above example to the `relationships` property of the `.magento.app.yaml` file. For example:
96
+
Add the endpoints defined in the above example to the `relationships` property of the `.magento.app.yaml` file. For example:
97
97
98
98
```yaml
99
99
relationships:
@@ -103,13 +103,13 @@ relationships:
103
103
```
104
104
105
105
{:.bs-callout-info}
106
-
If you configure one MySQL user, you cannot use the [`DEFINER`](http://dev.mysql.com/doc/refman/5.6/en/show-grants.html) access control mechanism for stored procedures and views.
106
+
If you configure one MySQL user, you cannot use the [`DEFINER`](https://dev.mysql.com/doc/refman/5.6/en/show-grants.html) access control mechanism for stored procedures and views.
107
107
108
108
## Connect to the database
109
109
110
110
Accessing the MariaDB database directly requires you to use a SSH to log in to the remote server, and connect to the database.
111
111
112
-
1. Log in to the remote server using SSH.
112
+
1. Log in to the remote server using a SSH.
113
113
114
114
1. Retrieve the MySQL login credentials from the `database` and `type` properties in the [$MAGENTO_CLOUD_RELATIONSHIPS]({{ site.baseurl }}/cloud/project/magento-app-properties.html#relationships) variable.
115
115
@@ -163,11 +163,11 @@ Accessing the MariaDB database directly requires you to use a SSH to log in to t
163
163
164
164
## Connect to secondary database
165
165
166
-
In some cases, you might need to connect to the secondary database, for example to improve database performance or resolve database locking issues. If this configuration is required, use `"port" : 3304` to establish the connection. See the [{{ site.data.var.ece }} database best practice](https://support.magento.com/hc/en-us/articles/360049045351) article in the _{{site.data.var.ee}} Help Center_.
166
+
Sometimes, you have to connect to the secondary database to improve database performance or resolve database locking issues. If this configuration is required, use `"port" : 3304` to establish the connection. See the [{{ site.data.var.ece }} database best practice](https://support.magento.com/hc/en-us/articles/360049045351) article in the _{{site.data.var.ee}} Help Center_.
167
167
168
168
## Troubleshooting
169
169
170
-
See the following {{site.data.var.ee}} Support articles for help troubleshooting MySQL problems:
170
+
See the following {{site.data.var.ee}} Support articles for help with troubleshooting MySQL problems:
171
171
172
172
- [Checking slow queries and processes MySQL](https://support.magento.com/hc/en-us/articles/360030903091-Checking-slow-queries-and-processes-MySQL-)
173
173
- [Create database dump on Cloud](https://support.magento.com/hc/en-us/articles/360003254334-Create-database-dump-on-Cloud)
0 commit comments