ruby-on-rails 创建rails项目 有Rails列类型的文档吗?




创建rails项目 (2)

从Rails主分支源代码中我发现:

抽象mysql_adapter

#activerecord/lib/active_record/connection_adapters/abstract_mysql_adapter.rb

  NATIVE_DATABASE_TYPES = {
    primary_key: "bigint auto_increment PRIMARY KEY",
    string:      { name: "varchar", limit: 255 },
    text:        { name: "text", limit: 65535 },
    integer:     { name: "int", limit: 4 },
    float:       { name: "float" },
    decimal:     { name: "decimal" },
    datetime:    { name: "datetime" },
    timestamp:   { name: "timestamp" },
    time:        { name: "time" },
    date:        { name: "date" },
    binary:      { name: "blob", limit: 65535 },
    boolean:     { name: "tinyint", limit: 1 },
    json:        { name: "json" },
  }

  # Maps logical Rails types to MySQL-specific data types.
  def type_to_sql(type, limit = nil, precision = nil, scale = nil, unsigned = nil)
    sql = case type.to_s
    when 'integer'
      integer_to_sql(limit)
    when 'text'
      text_to_sql(limit)
    when 'blob'
      binary_to_sql(limit)
    when 'binary'
      if (0..0xfff) === limit
        "varbinary(#{limit})"
      else
        binary_to_sql(limit)
      end
    else
      super(type, limit, precision, scale)
    end

    sql << ' unsigned' if unsigned && type != :primary_key
    sql
  end    

# and integer ...

  def integer_to_sql(limit) # :nodoc:
    case limit
    when 1; 'tinyint'
    when 2; 'smallint'
    when 3; 'mediumint'
    when nil, 4; 'int'
    when 5..8; 'bigint'
    else raise(ActiveRecordError, "No integer type has byte size #{limit}")
    end
  end

 # and text ..

  def text_to_sql(limit) # :nodoc:
    case limit
    when 0..0xff;               'tinytext'
    when nil, 0x100..0xffff;    'text'
    when 0x10000..0xffffff;     'mediumtext'
    when 0x1000000..0xffffffff; 'longtext'
    else raise(ActiveRecordError, "No text type has byte length #{limit}")
    end
  end

# and binary ...

    def binary_to_sql(limit) # :nodoc:
      case limit
      when 0..0xff;               "tinyblob"
      when nil, 0x100..0xffff;    "blob"
      when 0x10000..0xffffff;     "mediumblob"
      when 0x1000000..0xffffffff; "longblob"
      else raise(ActiveRecordError, "No binary type has byte length #{limit}")
      end
    end

type_to_sql方法中的super

#activerecord/lib/active_record/connection_adapters/abstract/schema_statements.rb
  def type_to_sql(type, limit = nil, precision = nil, scale = nil) #:nodoc:
    type = type.to_sym if type
    if native = native_database_types[type]
      column_type_sql = (native.is_a?(Hash) ? native[:name] : native).dup

      if type == :decimal # ignore limit, use precision and scale
        scale ||= native[:scale]

        if precision ||= native[:precision]
          if scale
            column_type_sql << "(#{precision},#{scale})"
          else
            column_type_sql << "(#{precision})"
          end
        elsif scale
          raise ArgumentError, "Error adding decimal column: precision cannot be empty if scale is specified"
        end

      elsif [:datetime, :time].include?(type) && precision ||= native[:precision]
        if (0..6) === precision
          column_type_sql << "(#{precision})"
        else
          raise(ActiveRecordError, "No #{native[:name]} type has precision of #{precision}. The allowed range of precision is from 0 to 6")
        end
      elsif (type != :primary_key) && (limit ||= native.is_a?(Hash) && native[:limit])
        column_type_sql << "(#{limit})"
      end

      column_type_sql
    else
      type.to_s
    end
  end

我正在寻找的不仅仅是这个页面上的简单类型列表:

:primary_key,:string,:text,:integer,:float,:decimal,:datetime,:timestamp,:time,:date,:binary,:boolean

但是有没有实际定义这些字段的文档?

特别:

  • :string:text什么区别?
  • :float:decimal
  • 什么是:time:timestamp:datetime :time的区别特征?

这些类型的细微差别是否记录在任何地方?

编辑: DB平台的实现点与我试图问的问题无关。 如果说, :datetime在Rails文档中没有定义的预期含义,那么在选择相应的列类型时,db-adapter-writer会做什么?


从个人经历中建立的指导方针

  • 字符串
    • 限制为255个字符(取决于DBMS)
    • 用于短文本字段(名称,电子邮件等)
  • 文本
    • 无限长度(取决于DBMS)
    • 用于评论,博客文章等一般经验法则:如果它通过textarea捕获,使用文本。 对于使用文本字段的输入,请使用字符串。
  • 整数
    • 整数
  • 浮动
    • 以浮点精度存储的十进制数字
    • 精确度是固定的,对于一些计算可能会有问题; 由于舍入不准确,通常对数学运算没有好处。
  • 十进制
    • 以精确度存储的十进制数字根据您的计算需要而变化; 将这些用于需要准确的数学
    • 有关示例以及有关浮点数和小数点之间差异的深入说明,请参阅this文章。
  • 布尔
    • 用来存储真/假属性(即只有两种状态的东西,比如开/关)
  • 二进制
    • 用于将图像,电影和其他文件以其原始原始格式存储在称为斑点的数据块中
  • :首要的关键
    • 这个数据类型是一个占位符,Rails可以转换成你选择的数据库所需要的任何主键数据类型(即postgreSQL中的serial primary key )。 它的使用有点复杂,不推荐。
    • 使用模型和迁移约束(如validates_uniqueness_ofadd_index :unique => true选项),而不是在您自己的字段之一上模拟主键功能。
  • 日期
    • 仅存储日期(年,月,日)
  • 时间
    • 只存储一次(小时,分钟,秒)
  • 日期时间
    • 存储日期和时间
  • 时间戳
    • 存储日期和时间
    • 注意:出于Rails的目的,Timestamp和DateTime意味着相同的事情(使用两种类型来存储日期和时间)。 对于TL; DR描述为什么两者都存在,请阅读下面的段落。

这些是通常存在混淆的类型; 我希望这有帮助。 我真的不知道为什么没有关于这些的官方文档。 另外,我想你提到的这些数据库适配器是由编写Rails的人编写的,所以他们在编写适配器时可能不需要任何文档。 希望这可以帮助!

注意:Rails的主要功能包括:DateTime:Timestamp ,主要用于与数据库系统兼容。 例如,MySQL的TIMESTAMP数据类型存储为一个unix时间戳。 其有效范围从1970年到2038年,时间存储为自上个epoch以来经过的秒数,这被认为是标准的,但实际上可能因系统而异。 认识到相对时间在数据库中不是一件好事,MySQL后来引入了DATETIME数据类型,它以年增加的代价存储年,月,日,小时,分和秒中的每个数字。 为保持向后兼容性,保留了TIMESTAMP数据类型。 其他数据库系统也经历了类似的变化。 Rails认识到存在多种标准,并为两者提供接口。 但是,Rails ActiveRecord默认存储在MySql的DATETIME :Timestamp:DateTime到UTC日期,所以它对Rails程序员没有任何功能差异。 这些存在使得希望区分这两者的用户可以这样做。 (有关更深入的解释,请参阅this答案)。





ruby-on-rails