如何快速上手 Dynamoid从 AWS 配置到第一个 DynamoDB 模型的完整教程【免费下载链接】dynamoidRuby ORM for Amazons DynamoDB.项目地址: https://gitcode.com/gh_mirrors/dy/dynamoidDynamoid 是 Ruby 生态中面向 Amazon DynamoDB 的 ORM 框架语法高度模仿 ActiveRecord。本教程带你快速完成 AWS 凭证配置、命名空间设置并写出第一个可增删改查的 DynamoDB 模型让你十几分钟就能跑通完整流程 为什么选择 DynamoidDynamoDB 的 Ruby ORM如果你熟悉 ActiveRecordDynamoid 几乎零学习成本。它提供了✅ 与 ActiveRecord 一致的create / find / where / update / destroy语法✅has_many、belongs_to、has_one、has_and_belongs_to_many原生关联支持✅ ActiveModel 验证与回调✅ 全局二级索引GSI、事务、乐观锁、STI 单表继承✅ 自动建表、Rake 任务、本地 DynamoDB 测试支持一句话定位它让 DynamoDB 像操作 MySQL 一样简单。一键安装Dynamoid 快速开始步骤在你的Gemfile中加入一行依赖gem dynamoid然后执行bundle install即可。⚠️版本兼容对照Dynamoid 3.x 搭配 AWS SDK 3.x当前主线版本Dynamoid 0.x 对应 AWS SDK 1.x请勿混用。依赖声明可见 dynamoid.gemspec。支持 Ruby 2.3 与 Rails 4.2 ~ 8.1。AWS 配置连接 DynamoDB 的 3 种方式方式一Rails 初始化器配置全局凭证创建config/initializers/aws.rbAws.config.update( region: us-west-2, credentials: Aws::Credentials.new(ACCESS_KEY_ID, SECRET_ACCESS_KEY) )方式二仅在 Dynamoid 内部指定凭证require dynamoid Dynamoid.configure do |config| config.access_key ACCESS_KEY_ID config.secret_key SECRET_ACCESS_KEY config.region us-west-2 end方式三传入预配置凭证对象适合使用 IAM Role 等场景直接config.credentials credentials即可。所有配置项的默认值定义在 lib/dynamoid/config.rb常用配置还有配置项作用默认值namespace表名前缀隔离不同环境dynamoidendpoint指向 DynamoDB Local 的地址nilread_capacity/write_capacity建表时的读写容量100 / 20timestamps是否自动生成created_at/updated_attrue开发时建议加一行config.endpoint http://localhost:8000直连本地 DynamoDB省钱又安全 5 分钟定义你的第一个 DynamoDB 模型Dynamoid 模型只需两步包含Dynamoid::Document模块 声明字段。以用户模型为例class User include Dynamoid::Document field :name field :email field :admin, :boolean field :last_logged_in_at, :datetime validates_presence_of :name endid、created_at、updated_at三个魔法列自动提供无需声明字段默认string类型还支持integer、number、set、array、map、datetime、boolean、serialized等忘了声明的字段会被直接忽略不会出现在模型上这是新手最常踩的坑完整示例可参考项目自带的 spec/app/models/user.rb。自定义表名与主键默认表名为表名前缀_users主键为id。如需自定义table name: :awesome_users, key: :user_id, read_capacity: 5, write_capacity: 5注意这些选项只对新建表生效不会修改已存在的表。声明排序键Range Keyclass Post include Dynamoid::Document range :posted_at, :datetime end建表与连通性检查Rake 任务一步到位Dynamoid 内置两个 Rake 任务实现见 lib/dynamoid/tasks/database.rakerake dynamoid:ping # 测试能否连通 DynamoDB rake dynamoid:create_tables # 为所有模型批量建表create_tables只创建缺失的表、不改动已有表。另外若配置了create_table_on_save: true默认开启第一次save时也会自动建表——对新手非常友好。CRUD 与查询像用 ActiveRecord 一样操作 DynamoDB# 创建 u User.new(name: Josh) u.email joshexample.com u.save u.id # 3a9f7216-4726-4aea-9fbc-8554ae9292cbUUID 字符串 # 查询 User.find(u.id) User.where(admin: true).all User.find_by_email(joshexample.com) # 更新 User.find(u.id).update_attributes(name: Joshua) # 批量删除高效分批执行 User.where(admin: false).delete_all查询还支持丰富操作符User.where(age.gt: 18) # 范围条件 User.where(name.begins_with: Jo) # 前缀匹配 User.where(age.between: [18, 30]) # 区间 User.record_limit(5).batch(100).each { |u| } # 限量 分批适合大表性能提示键属性条件请写成 Hash 形式走 Query字符串表达式只在过滤阶段生效走 Scan。大表扫描有成本能用 Query 就不用 Scan。关联与进阶特性速览class User include Dynamoid::Document has_many :addresses belongs_to :group, foreign_key: :group_id end class Address include Dynamoid::Document belongs_to :user # 自动与 User 关联 end进阶能力按需了解全局二级索引global_secondary_index hash_key: :age, projected_attributes: :all事务User.transaction { |t| t.create(User, ...); t.update_fields(...) }全部成功或全部回滚乐观锁加一个field :lock_version, :integer即可回调before_save、after_create、after_destroy等与 Rails 一致常见新手问题清单 问题原因与解法字段存不进去忘记在模型中field声明未声明字段会被丢弃连接失败检查region与凭证本地开发配置endpoint读写不一致DynamoDB 默认最终一致性需要强一致读用consistent_read: true成本翻倍测试互相污染测试环境按 namespace 隔离可在before(:each)中删表重建调试时可开启日志Dynamoid.config.logger.level :debug会输出每次请求的完整报文与耗时。总结从配置到模型的完整路线Gemfile添加gem dynamoid并安装配置 AWS 凭证与 region按需设置namespace和endpoint编写模型include Dynamoid::Document 声明fieldrake dynamoid:ping验证连通rake dynamoid:create_tables建表用 ActiveRecord 风格代码完成 CRUD 与查询按这条路线走下来你的 Ruby 应用已经可以流畅地操作 DynamoDB 了。更多配置项与 API 细节参考 README.md 与 CHANGELOG.md。【免费下载链接】dynamoidRuby ORM for Amazons DynamoDB.项目地址: https://gitcode.com/gh_mirrors/dy/dynamoid创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考