- C
- D
- E
- F
- I
- N
- R
- S
-
- show_variable,
- strict_mode?,
- supports_advisory_locks?,
- supports_bulk_alter?,
- supports_check_constraints?,
- supports_common_table_expressions?,
- supports_datetime_with_precision?,
- supports_explain?,
- supports_expression_index?,
- supports_foreign_keys?,
- supports_index_sort_order?,
- supports_indexes_in_create?,
- supports_insert_on_duplicate_skip?,
- supports_insert_on_duplicate_update?,
- supports_optimizer_hints?,
- supports_restart_db_transaction?,
- supports_transaction_isolation?,
- supports_views?,
- supports_virtual_columns?
常數
CR_SERVER_GONE_ERROR | = | 2006 |
CR_SERVER_LOST | = | 2013 |
EMULATE_BOOLEANS_TRUE | = | { emulate_booleans: true }.freeze |
ER_CANNOT_ADD_FOREIGN | = | 1215 |
ER_CANNOT_CREATE_TABLE | = | 1005 |
ER_CLIENT_INTERACTION_TIMEOUT | = | 4031 |
ER_CONNECTION_KILLED | = | 1927 |
ER_DATA_TOO_LONG | = | 1406 |
ER_DB_CREATE_EXISTS | = | 1007 |
請參閱 dev.mysql.com/doc/mysql-errors/en/server-error-reference.html |
||
ER_DO_NOT_HAVE_DEFAULT | = | 1364 |
ER_DUP_ENTRY | = | 1062 |
ER_FILSORT_ABORT | = | 1028 |
ER_FK_INCOMPATIBLE_COLUMNS | = | 3780 |
ER_LOCK_DEADLOCK | = | 1213 |
ER_LOCK_WAIT_TIMEOUT | = | 1205 |
ER_NOT_NULL_VIOLATION | = | 1048 |
ER_NO_REFERENCED_ROW | = | 1216 |
ER_NO_REFERENCED_ROW_2 | = | 1452 |
ER_OUT_OF_RANGE | = | 1264 |
ER_QUERY_INTERRUPTED | = | 1317 |
ER_QUERY_TIMEOUT | = | 3024 |
ER_ROW_IS_REFERENCED | = | 1217 |
ER_ROW_IS_REFERENCED_2 | = | 1451 |
EXTENDED_TYPE_MAPS | = | Concurrent::Map.new |
NATIVE_DATABASE_TYPES | = | { primary_key: "bigint auto_increment PRIMARY KEY", string: { name: "varchar", limit: 255 }, text: { name: "text" }, integer: { name: "int", limit: 4 }, bigint: { name: "bigint" }, float: { name: "float", limit: 24 }, decimal: { name: "decimal" }, datetime: { name: "datetime" }, timestamp: { name: "timestamp" }, time: { name: "time" }, date: { name: "date" }, binary: { name: "blob" }, blob: { name: "blob" }, boolean: { name: "tinyint", limit: 1 }, json: { name: "json" }, } |
類別公開方法
dbconsole(config, options = {}) 連結
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 57 def dbconsole(config, options = {}) mysql_config = config.configuration_hash args = { host: "--host", port: "--port", socket: "--socket", username: "--user", encoding: "--default-character-set", sslca: "--ssl-ca", sslcert: "--ssl-cert", sslcapath: "--ssl-capath", sslcipher: "--ssl-cipher", sslkey: "--ssl-key", ssl_mode: "--ssl-mode" }.filter_map { |opt, arg| "#{arg}=#{mysql_config[opt]}" if mysql_config[opt] } if mysql_config[:password] && options[:include_password] args << "--password=#{mysql_config[:password]}" elsif mysql_config[:password] && !mysql_config[:password].to_s.empty? args << "-p" end args << config.database find_cmd_and_exec(["mysql", "mysql5"], *args) end
emulate_booleans 連結
預設情況下,Mysql2Adapter
會將所有型別為 tinyint(1)
的欄位視為布林值。如果您想停用此模擬,可以在 application.rb 檔案中新增以下程式碼行
ActiveRecord::ConnectionAdapters::Mysql2Adapter.emulate_booleans = false
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 29 class_attribute :emulate_booleans, default: true
執行個體公開方法
charset() 連結
傳回資料庫字元集。
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 304 def charset show_variable "character_set_database" end
check_constraints(table_name) 連結
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 509 def check_constraints(table_name) if supports_check_constraints? scope = quoted_scope(table_name) sql = <<~SQL SELECT cc.constraint_name AS 'name', cc.check_clause AS 'expression' FROM information_schema.check_constraints cc JOIN information_schema.table_constraints tc USING (constraint_schema, constraint_name) WHERE tc.table_schema = #{scope[:schema]} AND tc.table_name = #{scope[:name]} AND cc.constraint_schema = #{scope[:schema]} SQL sql += " AND cc.table_name = #{scope[:name]}" if mariadb? chk_info = internal_exec_query(sql, "SCHEMA") chk_info.map do |row| options = { name: row["name"] } expression = row["expression"] expression = expression[1..-2] if expression.start_with?("(") && expression.end_with?(")") expression = strip_whitespace_characters(expression) unless mariadb? # MySQL returns check constraints expression in an already escaped form. # This leads to duplicate escaping later (e.g. when the expression is used in the SchemaDumper). expression = expression.gsub("\\'", "'") end CheckConstraintDefinition.new(table_name, expression, options) end else raise NotImplementedError end end
collation() 連結
傳回資料庫校對策略。
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 309 def collation show_variable "collation_database" end
create_database(name, options = {}) 連結
建立新的 MySQL
資料庫,並提供選用的 :charset
和 :collation
。預設字元集為 utf8mb4。
範例
create_database 'charset_test', charset: 'latin1', collation: 'latin1_bin'
create_database 'matt_development'
create_database 'matt_development', charset: :big5
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 279 def create_database(name, options = {}) if options[:collation] execute "CREATE DATABASE #{quote_table_name(name)} DEFAULT COLLATE #{quote_table_name(options[:collation])}" elsif options[:charset] execute "CREATE DATABASE #{quote_table_name(name)} DEFAULT CHARACTER SET #{quote_table_name(options[:charset])}" elsif row_format_dynamic_by_default? execute "CREATE DATABASE #{quote_table_name(name)} DEFAULT CHARACTER SET `utf8mb4`" else raise "Configure a supported :charset and ensure innodb_large_prefix is enabled to support indexes on varchar(255) string columns." end end
current_database() 連結
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 299 def current_database query_value("SELECT database()", "SCHEMA") end
drop_table(table_name, **options) 連結
從資料庫中刪除一個資料表。
:force
-
設為
:cascade
以同時刪除依賴物件。預設為 false。 :if_exists
-
設為
true
以僅在資料表存在時才刪除。預設為 false。 :temporary
-
設為
true
以刪除暫時資料表。預設為 false。
儘管此指令會忽略大多數 options
和區塊(如果提供的話),但提供這些內容在遷移的 change
方法中可能會有幫助,以便可以還原。在這種情況下,options
和區塊將由 create_table 使用。
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 357 def drop_table(table_name, **options) schema_cache.clear_data_source_cache!(table_name.to_s) execute "DROP#{' TEMPORARY' if options[:temporary]} TABLE#{' IF EXISTS' if options[:if_exists]} #{quote_table_name(table_name)}#{' CASCADE' if options[:force] == :cascade}" end
foreign_keys(table_name) 連結
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 464 def foreign_keys(table_name) raise ArgumentError unless table_name.present? scope = quoted_scope(table_name) # MySQL returns 1 row for each column of composite foreign keys. fk_info = internal_exec_query(<<~SQL, "SCHEMA") SELECT fk.referenced_table_name AS 'to_table', fk.referenced_column_name AS 'primary_key', fk.column_name AS 'column', fk.constraint_name AS 'name', fk.ordinal_position AS 'position', rc.update_rule AS 'on_update', rc.delete_rule AS 'on_delete' FROM information_schema.referential_constraints rc JOIN information_schema.key_column_usage fk USING (constraint_schema, constraint_name) WHERE fk.referenced_column_name IS NOT NULL AND fk.table_schema = #{scope[:schema]} AND fk.table_name = #{scope[:name]} AND rc.constraint_schema = #{scope[:schema]} AND rc.table_name = #{scope[:name]} SQL grouped_fk = fk_info.group_by { |row| row["name"] }.values.each { |group| group.sort_by! { |row| row["position"] } } grouped_fk.map do |group| row = group.first options = { name: row["name"], on_update: extract_foreign_key_action(row["on_update"]), on_delete: extract_foreign_key_action(row["on_delete"]) } if group.one? options[:column] = unquote_identifier(row["column"]) options[:primary_key] = row["primary_key"] else options[:column] = group.map { |row| unquote_identifier(row["column"]) } options[:primary_key] = group.map { |row| row["primary_key"] } end ForeignKeyDefinition.new(table_name, unquote_identifier(row["to_table"]), options) end end
index_algorithms() 連結
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 185 def index_algorithms { default: "ALGORITHM = DEFAULT", copy: "ALGORITHM = COPY", inplace: "ALGORITHM = INPLACE", instant: "ALGORITHM = INSTANT", } end
native_database_types() 連結
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 181 def native_database_types NATIVE_DATABASE_TYPES end
recreate_database(name, options = {}) 連結
刪除在 name
屬性上指定的資料庫,並使用提供的 options
重新建立它。
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 265 def recreate_database(name, options = {}) drop_database(name) sql = create_database(name, options) reconnect! sql end
rename_index(table_name, old_name, new_name) 連結
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 362 def rename_index(table_name, old_name, new_name) if supports_rename_index? validate_index_length!(table_name, new_name) execute "ALTER TABLE #{quote_table_name(table_name)} RENAME INDEX #{quote_table_name(old_name)} TO #{quote_table_name(new_name)}" else super end end
rename_table(table_name, new_name, **options) 連結
重新命名資料表。
範例
rename_table('octopuses', 'octopi')
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 334 def rename_table(table_name, new_name, **options) validate_table_length!(new_name) unless options[:_uses_legacy_table_name] schema_cache.clear_data_source_cache!(table_name.to_s) schema_cache.clear_data_source_cache!(new_name.to_s) execute "RENAME TABLE #{quote_table_name(table_name)} TO #{quote_table_name(new_name)}" rename_table_indexes(table_name, new_name) end
show_variable(name) 連結
SHOW VARIABLES LIKE ‘name’
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 578 def show_variable(name) query_value("SELECT @@#{name}", "SCHEMA") rescue ActiveRecord::StatementInvalid nil end
strict_mode?() 連結
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 629 def strict_mode? self.class.type_cast_config_to_boolean(@config.fetch(:strict, true)) end
supports_advisory_locks?() 連結
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 161 def supports_advisory_locks? true end
supports_bulk_alter?() 連結
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 96 def supports_bulk_alter? true end
supports_check_constraints?() 連結
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 128 def supports_check_constraints? if mariadb? database_version >= "10.3.10" || (database_version < "10.3" && database_version >= "10.2.22") else database_version >= "8.0.16" end end
supports_common_table_expressions?() 連結
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 153 def supports_common_table_expressions? if mariadb? database_version >= "10.2.1" else database_version >= "8.0.1" end end
supports_datetime_with_precision?() 連結
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 140 def supports_datetime_with_precision? mariadb? || database_version >= "5.6.4" end
supports_explain?() 連結
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 116 def supports_explain? true end
supports_expression_index?() 連結
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 104 def supports_expression_index? !mariadb? && database_version >= "8.0.13" end
supports_foreign_keys?() 連結
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 124 def supports_foreign_keys? true end
supports_index_sort_order?() 連結
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 100 def supports_index_sort_order? !mariadb? && database_version >= "8.0.1" end
supports_indexes_in_create?() 連結
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 120 def supports_indexes_in_create? true end
supports_insert_on_duplicate_skip?() 連結
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 165 def supports_insert_on_duplicate_skip? true end
supports_insert_on_duplicate_update?() 連結
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 169 def supports_insert_on_duplicate_update? true end
supports_optimizer_hints?() 連結
有關更多詳細資訊,請參閱 dev.mysql.com/doc/refman/en/optimizer-hints.html。
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 149 def supports_optimizer_hints? !mariadb? && database_version >= "5.7.7" end
supports_restart_db_transaction?() 連結
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 112 def supports_restart_db_transaction? true end
supports_transaction_isolation?() 連結
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 108 def supports_transaction_isolation? true end
supports_views?() 連結
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 136 def supports_views? true end
supports_virtual_columns?() 連結
來源:顯示 | 在 GitHub 上
# File activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb, line 144 def supports_virtual_columns? mariadb? || database_version >= "5.7.5" end