diff --git a/active-record-multiple-databases.html b/active-record-multiple-databases.html index 22d3d4f..97e1608 100644 --- a/active-record-multiple-databases.html +++ b/active-record-multiple-databases.html @@ -204,12 +204,12 @@

Нес
  • Какие особенности уже поддерживаются, а какие пока еще разрабатываются.
    • -

    По мере роста популярности и использования приложения, вам будет нужно масштабировать приложения для поддержки новых пользователей и их данных. Одно из направлений, в котором приложение может быть масштабировано, находится на уровне базы данных. Теперь в Rails есть поддержка нескольких баз данных, поэтому вам не нужно хранить все данные в одном месте.

    В настоящее время поддерживаются следующие особенности:

    1. Настройка приложения

    Хотя Rails старается сделать максимум работы за вас, все же требуется несколько шагов, чтобы подготовить приложение к нескольким базам данных.

    Предположим, у нас есть приложение с одной пишущей базой данных, и мы хотим добавить новую базу данных для нескольких новых таблиц. Имя новой базы данных будет "animals".

    config/database.yml выглядит так:

    production:
   database: my_primary_database
   adapter: mysql2
@@ -217,7 +217,7 @@ 
     Нес
   password: <%= ENV['ROOT_PASSWORD'] %>
    -

    Давайте добавим реплику для первой конфигурации, и вторую базу данных с именем animals, а также реплику для нее. Для этого нам нужно изменить конфигурацию database.yml из 2-уровневой в 3-уровневую.

    Если предоставлена конфигурация primary, она будет использована как конфигурация "по умолчанию". Если нет конфигурации с именем "primary", Rails использует первую конфигурацию как "по умолчанию" для каждой среды. Конфигурации по умолчанию будут использовать имена файлов Rails по умолчанию. Например, основные конфигурации будут использовать schema.rb для файла схемы, в то время как все остальные записи будут использовать имена файлов [CONFIGURATION_NAMESPACE]_schema.rb.

    +

    Давайте вторую базу данных с именем "animals", а также реплики для обоих баз данных. Для этого нам нужно изменить конфигурацию config/database.yml из 2-уровневой в 3-уровневую.

    Если предоставлена конфигурация primary, она будет использована как конфигурация "по умолчанию". Если нет конфигурации с именем primary, Rails использует первую конфигурацию как "по умолчанию" для каждой среды. Конфигурации по умолчанию будут использовать имена файлов Rails по умолчанию. Например, основные конфигурации будут использовать db/schema.rb для файла схемы, в то время как все остальные записи будут использовать имена файлов db/[CONFIGURATION_NAMESPACE]_schema.rb.

    production:
   primary:
     database: my_primary_database
@@ -244,30 +244,38 @@ 
     Нес
     replica: true
    -

    При использовании нескольких баз данных есть ряд важных настроек.

    Во-первых, имя базы данных для primary и primary_replica должно быть тем же самым, так как они содержат те же самые данные. То же самое для animals и animals_replica.

    Во-вторых, имя пользователя для пишущей базы и реплики должно быть различным, и права пользователя реплики базы данных должны быть установлены только для чтения, но не для записи.

    При использовании реплики базы данных нужно добавить запись replica: true для реплики в database.yml. Это нужно, потому что в противном случае Rails не сможет узнать, какая из них реплика, а какая пишущая. Rails не будет запускать определенные задачи, такие как миграции, на репликах.

    Наконец, для новой пишущей базы данных необходимо установить в migrations_paths директорию, в которой вы будете хранить миграции для этой базы данных. Мы рассмотрим migrations_paths позже в этом руководстве.

    Теперь, когда у нас есть новая база данных, давайте настроим модель соединения. Чтобы использовать новую базу данных, нам нужно создать новый абстрактный класс и соединить с базами данных животных.

    - 
    class AnimalsRecord < ApplicationRecord
+
    При использовании нескольких баз данных есть ряд важных настроек.
    Во-первых, имя базы данных для primary и primary_replica должно быть тем же самым, так как они содержат те же самые данные. То же самое для animals и animals_replica.
    Во-вторых, имя пользователя для пишущей базы и реплики должно быть различным, и права пользователя реплики базы данных должны быть установлены только для чтения, но не для записи.
    При использовании реплики базы данных нужно добавить запись replica: true для реплики в config/database.yml. Это нужно, потому что в противном случае Rails не сможет узнать, какая из них реплика, а какая пишущая. Rails не будет запускать определенные задачи, такие как миграции, на репликах.
    Наконец, для новой пишущей базы данных необходимо установить в ключе migrations_paths директорию, в которой вы будете хранить миграции для этой базы данных. Мы рассмотрим migrations_paths позже в этом руководстве.
    Вы также можете настроить файл дампа схемы, установив schema_dump на имя файла пользовательской схемы или полностью пропустить дамп схемы, установив schema_dump: false.
    Теперь, когда у нас есть новая база данных, давайте настроим модель соединения.
    Основную реплику базы данных можно настроить в ApplicationRecord следующим образом:
    
+  
    class ApplicationRecord < ActiveRecord::Base
   self.abstract_class = true
 
-  connects_to database: { writing: :animals, reading: :animals_replica }
+  connects_to database: { writing: :primary, reading: :primary_replica }
 end
 
    
 
    
-
    Затем нужно обновить ApplicationRecord, чтобы он знал о нашей реплике.
    
-  
    class ApplicationRecord < ActiveRecord::Base
-  self.abstract_class = true
+
    При использовании по-другому названного класса в вашем приложении необходимо вместо этого установить primary_abstract_class, таким образом Rails будет знать, с каким классом должен делиться соединением ActiveRecord::Base.
    
+  
    class PrimaryApplicationRecord < ActiveRecord::Base
+  primary_abstract_class
 
   connects_to database: { writing: :primary, reading: :primary_replica }
 end
 
    
 
    
-
    При использовании по-другому названного класса в вашем приложении необходимо вместо этого установить primary_abstract_class, таким образом Rails будет знать, с каким классом должен делиться соединением ActiveRecord::Base.
    
-  
    class PrimaryApplicationRecord < ActiveRecord::Base
-  self.primary_abstract_class = true
+
    В этом случае классы, которые подключаются к primary/primary_replica, могут наследоваться от вашего основного абстрактного класса, так же как стандартные приложения Rails делают это с помощью ApplicationRecord.
    
+  
    class Person < PrimaryApplicationRecord
+end
+
    
+
    
+
    С другой стороны, нам нужно настроить наши модели, сохраняемые в базе данных "animals":
    
+  
    class AnimalsRecord < ApplicationRecord
+  self.abstract_class = true
+
+  connects_to database: { writing: :animals, reading: :animals_replica }
 end
 
    
 
    
-
    Классы, соединяющиеся к primary/primary_replica могут наследоваться от вашего основного абстрактного класса, как в стандартных приложениях Rails:
    
-  
    class Person < ApplicationRecord
+
    Эти модели должны наследоваться от этого общего абстрактного класса:
    
+  
    class Car < AnimalsRecord
+  # Автоматически общается с базой данных animals.
 end
 
    
 
    
@@ -276,36 +284,38 @@ 
     Нес
 config.active_record.reading_role = :readonly
 
    
 
    
-
    Важно, что нужно соединяться с базой данных в единственной модели, а затем наследоваться от этой модели, а не соединять несколько отдельных моделей с той же самой базой данных. У клиентов базы данных есть ограничение на количество доступных открытых соединений, и, если вы сделаете так, это умножит количество соединений, так как Rails использует имя класса модели в качестве имени спецификации соединения.
    Теперь, когда у нас есть database.yml, и настроена новая модель, пришло время создать базы данных. Rails 6.0 поставляется со всеми задачами rails, нужными для использования нескольких баз данных в Rails.
    Можно запустить bin/rails -T для просмотра всех заданий, которые можно выполнить. Вы должны увидеть следующее:
    
-  
    $ bin/rails -T
-rails db:create                          # Creates the database from DATABASE_URL or config/database.yml for the ...
-rails db:create:animals                  # Create animals database for current environment
-rails db:create:primary                  # Create primary database for current environment
-rails db:drop                            # Drops the database from DATABASE_URL or config/database.yml for the cu...
-rails db:drop:animals                    # Drop animals database for current environment
-rails db:drop:primary                    # Drop primary database for current environment
-rails db:migrate                         # Migrate the database (options: VERSION=x, VERBOSE=false, SCOPE=blog)
-rails db:migrate:animals                 # Migrate animals database for current environment
-rails db:migrate:primary                 # Migrate primary database for current environment
-rails db:migrate:status                  # Display status of migrations
-rails db:migrate:status:animals          # Display status of migrations for animals database
-rails db:migrate:status:primary          # Display status of migrations for primary database
-rails db:reset                           # Drops and recreates all databases from their schema for the current environment and loads the seeds
-rails db:reset:animals                   # Drops and recreates the animals database from its schema for the current environment and loads the seeds
-rails db:reset:primary                   # Drops and recreates the primary database from its schema for the current environment and loads the seeds
-rails db:rollback                        # Rolls the schema back to the previous version (specify steps w/ STEP=n)
-rails db:rollback:animals                # Rollback animals database for current environment (specify steps w/ STEP=n)
-rails db:rollback:primary                # Rollback primary database for current environment (specify steps w/ STEP=n)
-rails db:schema:dump                     # Creates a database schema file (either db/schema.rb or db/structure.sql  ...
-rails db:schema:dump:animals             # Creates a database schema file (either db/schema.rb or db/structure.sql  ...
-rails db:schema:dump:primary             # Creates a db/schema.rb file that is portable against any DB supported  ...
-rails db:schema:load                     # Loads a database schema file (either db/schema.rb or db/structure.sql  ...
-rails db:schema:load:animals             # Loads a database schema file (either db/schema.rb or db/structure.sql  ...
-rails db:schema:load:primary             # Loads a database schema file (either db/schema.rb or db/structure.sql  ...
-rails db:setup                           # Creates all databases, loads all schemas, and initializes with the seed data (use db:reset to also drop all databases first)
-rails db:setup:animals                   # Creates the animals database, loads the schema, and initializes with the seed data (use db:reset:animals to also drop the database first)
-rails db:setup:primary                   # Creates the primary database, loads the schema, and initializes with the seed data (use db:reset:primary to also drop the database first)
-
    
+
    Важно, что нужно соединяться с базой данных в единственной модели, а затем наследоваться от этой модели, а не соединять несколько отдельных моделей с той же самой базой данных. У клиентов базы данных есть ограничение на количество доступных открытых соединений, и, если вы сделаете так, это умножит количество соединений, так как Rails использует имя класса модели в качестве имени спецификации соединения.
    Теперь, когда у нас есть config/database.yml, и настроена новая модель, пришло время создать базы данных. Rails поставляется со всеми командами, нужными для использования нескольких баз данных.
    Можно запустить bin/rails --help для просмотра всех заданий, которые можно выполнить. Вы должны увидеть следующее:
    
+  
    $ bin/rails --help
+...
+db:create                          # Create the database from DATABASE_URL or config/database.yml for the ...
+db:create:animals                  # Create animals database for current environment
+db:create:primary                  # Create primary database for current environment
+db:drop                            # Drop the database from DATABASE_URL or config/database.yml for the cu...
+db:drop:animals                    # Drop animals database for current environment
+db:drop:primary                    # Drop primary database for current environment
+db:migrate                         # Migrate the database (options: VERSION=x, VERBOSE=false, SCOPE=blog)
+db:migrate:animals                 # Migrate animals database for current environment
+db:migrate:primary                 # Migrate primary database for current environment
+db:migrate:status                  # Display status of migrations
+db:migrate:status:animals          # Display status of migrations for animals database
+db:migrate:status:primary          # Display status of migrations for primary database
+db:reset                           # Drop and recreates all databases from their schema for the current environment and loads the seeds
+db:reset:animals                   # Drop and recreates the animals database from its schema for the current environment and loads the seeds
+db:reset:primary                   # Drop and recreates the primary database from its schema for the current environment and loads the seeds
+db:rollback                        # Roll the schema back to the previous version (specify steps w/ STEP=n)
+db:rollback:animals                # Rollback animals database for current environment (specify steps w/ STEP=n)
+db:rollback:primary                # Rollback primary database for current environment (specify steps w/ STEP=n)
+db:schema:dump                     # Create a database schema file (either db/schema.rb or db/structure.sql  ...
+db:schema:dump:animals             # Create a database schema file (either db/schema.rb or db/structure.sql  ...
+db:schema:dump:primary             # Create a db/schema.rb file that is portable against any DB supported  ...
+db:schema:load                     # Load a database schema file (either db/schema.rb or db/structure.sql  ...
+db:schema:load:animals             # Load a database schema file (either db/schema.rb or db/structure.sql  ...
+db:schema:load:primary             # Load a database schema file (either db/schema.rb or db/structure.sql  ...
+db:setup                           # Create all databases, loads all schemas, and initializes with the seed data (use db:reset to also drop all databases first)
+db:setup:animals                   # Create the animals database, loads the schema, and initializes with the seed data (use db:reset:animals to also drop the database first)
+db:setup:primary                   # Create the primary database, loads the schema, and initializes with the seed data (use db:reset:primary to also drop the database first)
+...
+
    
 
    
 
    Запуск команды bin/rails db:create создаст и основную базу, и базу животных. Отметьте, что нет команды для создания пользователей базы данных, и вам нужно это сделать вручную для поддержки пользователей только для чтения в репликах. Если нужно создать базу животных, можно выполнить bin/rails db:create:animals.
    2. Соединение с базами данных без управления схемой и миграциями
    Если вы хотите соединиться с внешней базой данных без каких-либо задач управления базой данных, таких как управление схемой, миграции, сиды, и т.д., можно установить для базы данных конфигурационную настройку database_tasks: false. По умолчанию она установлена как true.
    
   
    production:
@@ -326,7 +336,7 @@ 
    $ bin/rails generate scaffold Dog name:string --database animals
 
    
 
    
-
    Будет создан класс с именем базы данных плюс Record. В данном примере база данных Animals, поэтому получаем AnimalsRecord:
    
+
    Будет создан класс с camelized именем базы данных плюс Record. В данном примере база данных animals, поэтому получаем AnimalsRecord:
    
   
    class AnimalsRecord < ApplicationRecord
   self.abstract_class = true
 
@@ -339,12 +349,12 @@ 
    end
 
    
 
    
-
    Note: Так как Rails не знает, какая база данных является репликой для пишущей базы, необходимо это добавить в абстрактный класс по завершении.
    Rails сгенерирует новый класс единожды. Он не будет переписан новыми скаффолдами или удален при удалении скаффолда.
    Если у вас уже есть абстрактный класс, и его имя отличается от AnimalsRecord, можно передать опцию --parent для обозначения, что нужен иной абстрактный класс:
    
+
    Так как Rails не знает, какая база данных является репликой для пишущей базы, необходимо это добавить в абстрактный класс по завершении.
    Rails сгенерирует AnimalsRecord единожды. Он не будет переписан новыми скаффолдами или удален при удалении скаффолда.
    Если у вас уже есть абстрактный класс, и его имя отличается от AnimalsRecord, можно передать опцию --parent для обозначения, что нужен иной абстрактный класс:
    
   
    $ bin/rails generate scaffold Dog name:string --database animals --parent Animals::Record
 
    
 
    
-
    Это пропустит генерацию AnimalsRecord, так как вы обозначили Rails, что хотите использовать другой родительский класс.
    4. Активация автоматического переключения роли
    Наконец, чтобы использовать реплику только для чтения, нужно активировать промежуточную программу для автоматического переключения.
    Автоматическое переключение позволяет приложению переключаться с пишущей базы на реплику или с реплики на пишущую, основываясь на методе HTTP, и того, была ли недавно запись запрашивающим пользователем.
    Если приложение получает запрос POST, PUT, DELETE или PATCH, приложение автоматически будет писать в пишущую базу данных. За указанное время после записи, приложение будет читать из основной базы. Для запроса GET или HEAD приложение будет читать из реплики, если нет недавней записи.
    Чтобы активировать промежуточную программу автоматического переключения соединений, можно запустить генератор автоматического переключения:
    
-  
    $ bin/rails g active_record:multi_db
+
    Это пропустит генерацию AnimalsRecord, так как вы обозначили Rails, что хотите использовать другой родительский класс.
    4. Активация автоматического переключения роли
    Наконец, чтобы использовать реплику только для чтения, нужно активировать промежуточную программу для автоматического переключения.
    Автоматическое переключение позволяет приложению переключаться с пишущей базы на реплику или с реплики на пишущую, основываясь на методе HTTP, и того, была ли недавно запись запрашивающим пользователем.
    Если приложение получает запрос POST, PUT, DELETE или PATCH, приложение автоматически будет писать в пишущую базу данных. Если запрос не относится к одному из перечисленных методов, но приложение недавно совершало запись, то дополнительно будет использована база данных для записи. Все остальные запросы будут использовать базу данных-реплику.
    Чтобы активировать промежуточную программу автоматического переключения соединений, можно запустить генератор автоматического переключения:
    
+  
    $ bin/rails g active_record:multi_db
 
    
 
    
 
    А затем раскомментируйте следующие строчки.
    
@@ -356,8 +366,27 @@ 
    
-  
    class MyCookieResolver
-  # код вашего класса для куки
+  
    class MyCookieResolver < ActiveRecord::Middleware::DatabaseSelector::Resolver
+  def self.call(request)
+    new(request.cookies)
+  end
+
+  def initialize(cookies)
+    @cookies = cookies
+  end
+
+  attr_reader :cookies
+
+  def last_write_timestamp
+    self.class.convert_timestamp_to_time(cookies[:last_write])
+  end
+
+  def update_last_write_timestamp
+    cookies[:last_write] = self.class.convert_time_to_timestamp(Time.now)
+  end
+
+  def save(response)
+  end
 end
 
    
 
    
@@ -369,13 +398,13 @@ 
    5. Использование ручного переключения соединения
    Имеется ряд случаев, когда хочется, чтобы приложение соединялось с пишущей базой или репликой, и автоматического переключения не достаточно. Например, вы знаете, что для определенного запроса нужно всегда отправлять запрос к реплике, даже если это в запросе POST.
    Для этого Rails предоставляет метод connected_to, который переключит на нужное вам соединение.
    
   
    ActiveRecord::Base.connected_to(role: :reading) do
-  # весь код в этом блоке будет соединен с ролью reading
+  # Весь код в этом блоке будет соединен с ролью reading.
 end
 
    
 
    
 
    "role" в вызове connected_to ищет соединения, связанные с обработчиком этого соединения (или роли). Обработчик соединения reading содержит все соединения, связанные с помощью connects_to с именем роли reading.
    Отметьте, что connected_to с ролью будет искать существующее соединение и переключать с помощью указанного имени соединения. Это означает, что, если вы передали неизвестную роль, наподобие connected_to(role: :nonexistent), то получите ошибку, сообщающую ActiveRecord::ConnectionNotEstablished (No connection pool with 'AnimalsBase' found for the 'nonexistent' role.)
    Если хотите, чтобы Rails убедился, что любые выполняемые запросы только читают, передайте prevent_writes: true. Это только предотвратит запросы, выглядящие как запись, от отправления в базу данных. Вы также должны настроить свою реплику базы данных запускаться в режиме только для чтения.
    
   
    ActiveRecord::Base.connected_to(role: :reading, prevent_writes: true) do
-  # Rails проверит каждый запрос, чтобы убедиться, что он читает
+  # Rails проверит каждый запрос, чтобы убедиться, что он читает.
 end
 
    
 
    
@@ -391,46 +420,65 @@ 
    primary_shard_one:
     database: my_primary_shard_one
     adapter: mysql2
+    migrations_paths: db/migrate_shards
   primary_shard_one_replica:
     database: my_primary_shard_one
     adapter: mysql2
     replica: true
+  primary_shard_two:
+    database: my_primary_shard_two
+    adapter: mysql2
+    migrations_paths: db/migrate_shards
+  primary_shard_two_replica:
+    database: my_primary_shard_two
+    adapter: mysql2
+    replica: true
 
    
 
    
 
    Затем модели соединяются с помощью ключа shards в API connects_to:
    
   
    class ApplicationRecord < ActiveRecord::Base
+  primary_abstract_class
+
+  connects_to database: { writing: :primary, reading: :primary_replica }
+end
+
+class ShardRecord < ApplicationRecord
   self.abstract_class = true
 
   connects_to shards: {
-    default: { writing: :primary, reading: :primary_replica },
-    shard_one: { writing: :primary_shard_one, reading: :primary_shard_one_replica }
+    shard_one: { writing: :primary_shard_one, reading: :primary_shard_one_replica },
+    shard_two: { writing: :primary_shard_two, reading: :primary_shard_two_replica }
   }
 end
 
    
 
    
-
    Затем в моделях можно вручную переключать соединения с помощью API connected_to. При использования шардинга должны быть переданы обе role и shard:
    
+
    Если вы используете шардинг, убедитесь, что параметры migrations_paths и schema_dump остаются одинаковыми для всех шардов. При генерации миграции вы можете передать опцию --database и использовать одно из имен шардов. Поскольку все они указывают на один и тот же путь, не имеет значения, какой из них вы выберете.
    
+  
    $ bin/rails g scaffold Dog name:string --database primary_shard_one
+
    
+
    
+
    Затем в моделях можно вручную переключать шарды с помощью API connected_to. При использования шардинга должны быть переданы обе role и shard:
    
   
    ActiveRecord::Base.connected_to(role: :writing, shard: :default) do
-  @id = Person.create! # Создаст запись в shard default
+  @id = Person.create! # Создаст запись в шард с именем ":default".
 end
 
 ActiveRecord::Base.connected_to(role: :writing, shard: :shard_one) do
   Person.find(@id) # Не найдет запись, не существует, так как было создано
-                   # в shard default
+                   # в шарде с именем ":default".
 end
 
    
 
    
 
    API горизонтального шардинга также поддерживает чтение из реплик. Можно переключить роли и шард с помощью API connected_to.
    
   
    ActiveRecord::Base.connected_to(role: :reading, shard: :shard_one) do
-  Person.first # Ищет запись в реплике shard one
+  Person.first # Ищет запись в реплике shard one.
 end
 
    
 
    
 
    7. Активизация автоматического переключения шарда
    Приложения могут автоматически переключать шарды для запроса с помощью предоставленной промежуточной программы.
    Промежуточная программа ShardSelector предоставляет фреймворк для автоматического переключения шардов. Rails предоставляет базовый фреймворк для определения, на какой шард переключиться, и позволяет по необходимости писать в приложениях пользовательские стратегии для переключения.
    ShardSelector принимает ряд опций (в настоящее время поддерживается только lock), которые могут быть использованы промежуточной программой для изменения поведения. lock по умолчанию true, и запретит запросу переключать шарды пока внутри блока. Если lock false, то переключение шарда будет разрешено.
 Для шардинга, основанного на tenant, lock должен всегда быть true для предотвращения кода приложения от ошибочного переключения между tenant.
    Тот же генератор, что и для выбора базы данных, может быть использован для генерации файла для автоматического переключения шарда:
    
-  
    $ bin/rails g active_record:multi_db
+  
    $ bin/rails g active_record:multi_db
 
    
 
    
-
    Затем в файле раскомментируйте следующее:
    
+
    Затем в сгенерированном config/initializers/multi_db.rb раскомментируйте следующее:
    
   
    Rails.application.configure do
   config.active_record.shard_selector = { lock: true }
   config.active_record.shard_resolver = ->(request) { Tenant.find_by!(host: request.host).shard }
@@ -445,25 +493,28 @@ 
    8. Гранулированное переключение соединения с базой данных
    В Rails 6.1 возможно переключать соединения для одной базы данных вместо глобального для всех баз данных.
    С гранулированным переключением соединения с базой данных, любой абстрактный класс будет способен переключать соединения, не затрагивая другие соединения. Это полезно для переключения запросов AnimalsRecord на чтение из реплики, в то время как запросы ApplicationRecord идут в основную базу.
    
+
    8. Гранулированное переключение соединения с базой данных
    Начиная с Rails 6.1, возможно переключать соединения для одной базы данных вместо глобального для всех баз данных.
    С гранулированным переключением соединения с базой данных, любой абстрактный класс будет способен переключать соединения, не затрагивая другие соединения. Это полезно для переключения запросов AnimalsRecord на чтение из реплики, в то время как запросы ApplicationRecord идут в основную базу.
    
   
    AnimalsRecord.connected_to(role: :reading) do
-  Dog.first # Читает из animals_replica
-  Person.first  # Читает из primary
+  Dog.first # Читает из animals_replica.
+  Person.first  # Читает из primary.
 end
 
    
 
    
 
    Также возможно гранулировано менять соединения для шардов.
    
   
    AnimalsRecord.connected_to(role: :reading, shard: :shard_one) do
-  Dog.first # Прочитает из shard_one_replica. Если не существует соединения
-  #  для shard_one_replica, будет вызвана ошибка ConnectionNotEstablished
-  Person.first # Прочитает из основной пишущей базы
+  # Прочитает из shard_one_replica. Если не существует соединения для shard_one_replica,
+  # будет вызвана ошибка ConnectionNotEstablished.
+  Dog.first
+
+  # Прочитает из основной пишущей базы.
+  Person.first
 end
 
    
 
    
 
    Чтоб переключить только основной кластер базы данных, используйте ApplicationRecord:
    
   
    ApplicationRecord.connected_to(role: :reading, shard: :shard_one) do
-  Person.first # Читает из primary_shard_one_replica
-  Dog.first # Читает из animals_primary
+  Person.first # Читает из primary_shard_one_replica.
+  Dog.first # Читает из animals_primary.
 end
 
    
 
    
@@ -496,9 +547,10 @@ 
    8.2. Кэширование схемы
    Если вы хотите загрузить кэш схемы для каждой базы данных, вам нужно установить schema_cache_path в каждой конфигурации базы данных и установить config.active_record.lazily_load_schema_cache = true в конфигурации приложения. Отметьте, что это лениво загрузит кэш при установлении соединений с базами данных.
    9. Предостережения
    9.1. Нагрузочная балансировка реплик
    Rails также не поддерживает автоматическую нагрузочную балансировку реплик. Это очень зависит от вашей инфраструктуры. В будущем может быть будет реализована базовая, примитивная нагрузочная балансировка, но для масштабирования приложения должно быть что-то, что управляет вашим приложением вне Rails.
    
+
    Есть ряд важных вещей, которые нужно знать об этой опции:
    • Может быть влияние на производительность, сейчас будут выполняться два или более запросов (в зависимости от связи) вместо соединения. Если выборка для humans возвратит большое количество ID, в выборку для treats может быть послано слишком много ID.
+
    • Поскольку мы больше не выполняем соединения, запросы с сортировкой или лимитом теперь сортируются в памяти, так как упорядочивание из одной таблицы не может быть применено к другой таблице.
+
    • Эта настройка должна быть добавлена ко всем связям, где вы хотите отключить соединение. Rails не может угадать это, так как загрузка связей ленивая, и чтобы загрузить treats in @dog.treats Rails уже нужно знать, какой SQL должен быть сгенерирован.
+
    8.2. Кэширование схемы
    Если вы хотите загрузить кэш схемы для каждой базы данных, вам нужно установить schema_cache_path в каждой конфигурации базы данных и установить config.active_record.lazily_load_schema_cache = true в конфигурации приложения. Отметьте, что это лениво загрузит кэш при установлении соединений с базами данных.
    9. Предостережения
    9.1. Нагрузочная балансировка реплик
    Rails не поддерживает автоматическую нагрузочную балансировку реплик. Это очень зависит от вашей инфраструктуры. В будущем может быть будет реализована базовая, примитивная нагрузочная балансировка, но для масштабирования приложения должно быть что-то, что управляет вашим приложением вне Rails.