Database and RDBMS¶
Oro application uses RDBMS to store application data and uses Doctrine to interact with the database. The Doctrine capabilities are extended with additional DBAL functions and types in the Oro Doctrine Extensions library.
Oro Community Edition (CE) applications officially support only MySQL (5.7 or higher).
With Oro Enterprise Edition (EE) applications, you can use either MySQL (5.7 or higher) or PostgreSQL (9.6 and higher).
PostgreSQL v.10 is not currently supported in Oro EE applications because of a Doctrine Bug. This may change once the bugfix is out.
Setup and Configuration¶
DataBase connection is configured using the following parameters placed in config/parameters.yml:
database_driver: pdo_pgsql database_host: 127.0.0.1 database_port: null database_name: commerce_crm_ee database_user: postgres database_password: null
Supported database_driver values are pdo_pgsql for PostgreSQL and pdo_mysql for MySQL.
DBAL and ORM¶
The configuration may be changed in config.yml. Every registered Oro bundle has a Resources/config/oro/app.yml file which is merged with the global config.yml. This means that system configuration may be extended from a particular bundle for all applications without the need to change the global config.yml file.
Doctrine provides a limited set of DQL functions that may be used by a developer. To extend this list, Oro has its own extensions library. New DQL functions are added to the Doctrine configuration with either the app.yml or config.yml file placed in the EntityBundle of the Platform project. New functions may be implemented in any bundle and added into its app.yml in the following format:
doctrine: orm: dql: string_functions: group_concat: Oro\ORM\Query\AST\Functions\String\GroupConcat
The same file can be used to add new data types, for example:
doctrine: dbal: types: duration: Oro\Bundle\EntityBundle\DoctrineExtensions\DBAL\Types\DurationType
Enabling metadata cache is strongly recommended for the development and productions environments to improve performance. Metadata caching in Oro platform is done with the doctrine.metadata.cache service.
doctrine: orm: entity_managers: default: metadata_cache_driver: type: service id: doctrine.metadata.cache
More details on DoctrineBundle configuration are available in the Doctrine Configuration article on Symfony website.
Scalability and Performance Recommendations¶
It is recommended to use a separate hard drive (preferably a SSD) for the database server.
By default, databases are installed with a configuration applicable to slow hardware with a limited amount of memory and some options should be changed after installation for optimal performance.
MySQL configuration can be optimized using Percona Configuration Wizard.
Apply Percona’s best practices to achieve better MySQL database performance and avoid the complexity and risks of customizing my.cnf configuration on your own. For this, copy and paste the results of the Percona Configuration Wizard for MySQL into your *my.cnf* file.
MySQL/MariaDB database table can sometimes crash because of an unexpected server shutdown, a sudden file system corruption, or during the copy operation when the database is still in use. However, you can use a free open source tool called mysqlcheck which can automatically check, repair and optimize databases of all tables in Linux.
mysqlcheck -u root -p --auto-repair --check --optimize databasename
Use mysqltuner tool to review MySQL installation quickly and make adjustments to increase performance and stability.
To download and run it, use the following set of commands:
wget http://mysqltuner.pl mysqltuner.pl ./mysqltuner.pl
To choose optimal PostgreSQL configuration parameters, you can use PGTune configuration calculator.
PGTune calculates the configuration for PostgreSQL following the maximum performance for a given hardware configuration.
Many settings depend not only on the hardware configuration, but also on the size of the database, the number of clients and the complexity of queries. To achieve optimal configuration the PostgreSQL database, take into account all of these parameters.
A postgresqltuner.pl is a simple script that helps you analyse a PostgreSQL database. It is similar to by mysqltuner.pl discussed above and has the same propose.
wget https://postgresqltuner.pl postgresqltuner.pl ./postgresqltuner.pl
PostgreSQL has a highly recommended feature called autovacuum aimed at automating the execution of VACUUM and ANALYZE commands.
When enabled, autovacuum checks for tables that have had a large number of inserted, updated or deleted tuples.
These checks use the statistics collection facility; therefore, autovacuum cannot be used unless track_counts is set to true. In the default configuration, autovacuuming is enabled and related configuration parameters are appropriately set.
Do not select All (SELECT *) columns when only certain fields are required. Broadly speaking, the fewer columns you ask for, the less data must be loaded from disk when processing your query and less data to send over network.
If only columns stored in the index are requested, data will be loaded only from the index without reading data from the table.
This recommendation should be followed while working with complex queries that return a known set of fields: the repository methods that are not designed to return entity, datagrid queries, etc.
Add indexes only under the following circumstances:
- When you know how table will be queried.
- When you know that the index field will be a part of the where clause.
- When a field is highly selectable.
When all the conditions apply, the field makes a good candidate for pre-emptive tuning. Otherwise, do not add indexes to all fields because this will slow down insert/update operations and will require more disk space.
When metadata caching is turned on, then no changes to an entity will be seen by the doctrine until cache is refreshed. Remember to clear metadata cache every time time metadata is changed.
Like most ORMs, Doctrine ORM performs Hydration when converting database results into objects.
This process usually involves reading a record from a database result and then converting the column values into the object properties.
It may lead to performance degradation when several collections are hydrated in one query. The process of hydration becomes extremely costly when more than 2 LEFT JOIN operations clauses are part of queries.
More details on hydration are available in the Doctrine ORM Hydration Performance Optimization article.
Security and ACL¶
To protect your query by ACL, call AclHelper:apply to apply ACL restrictions to a given query.
- MySQL Documentation
- PostgreSQL Documentation
- Doctrine Extensions
- Oro application system requirements
- PGTune – Configuration calculator for PostgreSQL
- Percona Configuration Wizard for MySQL (you might need to sign it to use the wizard)
- PostgreSQL Performance Optimization
- PostgreSQL Tuner
- Symfony: DoctrineBundle Configuration
- Doctrine ORM Hydration Performance Optimization
- Logging Conventions
- Using Explain
- Explain Output