Ruby驱动程序入门

安装依赖项。

在开始开发之前，请确保在开发环境中安装Ruby版本 2.7 或更高版本。macOS 和某些Linux发行版上预装了Ruby ，但您可能需要更新版本。

创建项目目录。

在Shell中运行以下命令，为此项目创建一个名为 ruby-quickstart 的目录：

mkdir ruby-quickstart

然后运行以下命令，在 ruby-quickstart目录中创建 quickstart.rb文件：

cd ruby-quickstart
touch quickstart.rb

Add the Ruby driver to your project.

打开 quickstart.rb文件并添加以下代码：

require 'bundler/inline'
gemfile do
  source 'https://rubygems.org'
  gem 'mongo'
end

此代码使用 Bundler 依赖项管理工具将 Ruby 驱动程序添加为依赖项。

gemfile do
   source 'https://rubygems.org'
   gem 'mongo'
   gem 'bigdecimal'
end

在Atlas上创建免费的MongoDB部署。

完成MongoDB入门指南，设立新的Atlas帐户并将示例数据加载到新的免费套餐MongoDB部署。

保存您的凭证。

创建数据库用户后，请将该用户的用户名和密码保存在一个安全位置，以便在后续步骤中使用。

查找MongoDB Atlas连接字符串。

要检索您在上一步中创建的部署的连接字符串，登录您的Atlas帐户并导航到Clusters 部分下的Database 页面。单击新部署的Connect 按钮。

如果您尚未配置数据库用户， MongoDB将提示您创建并配置新用户。

Click the Drivers button under Connect to your application section and select "Ruby" from the Driver selection menu and the version that best matches the version you installed from the Version selection menu.

确保取消选择 View full code sample 选项以仅查看连接字符串。

复制连接字符串。

单击连接字符串右侧的“复制”按钮，将其复制到剪贴板，如下图所示：

更新密码占位符。

将此连接字符串粘贴到首选文本编辑器中的文件中，并将 <db_password> 占位符替换为数据库用户的密码。连接字符串已填充数据库用户的用户名。

将此文件保存到安全位置，以便在下一步中使用。

编辑Ruby应用程序文件。

导航到 ruby-quickstart目录中的 quickstart.rb文件。请将以下代码复制并粘贴到本教程“下载和安装”步骤中的 Bundler 代码下方。此代码连接到MongoDB并查询 sample_mflix数据库中的 movies集合。

uri = '<connection string>'
begin
  client = Mongo::Client.new(uri)
  database = client.use('sample_mflix')
  movies = database[:movies]
  # Queries for a movie that has the title 'Back to the Future'
  query = { title: 'Back to the Future' }
  movie = movies.find(query).first
  # Prints the movie document
  puts movie
ensure
  client&.close
end

指定连接字符串。

将 <connection string> 占位符替换为从本教程的创建连接字符串步骤中复制的连接字符串。

Run your Ruby application.

在 ruby-quickstart目录中，运行以下Shell命令以运行应用程序：

ruby quickstart.rb

命令行输出包含有关检索到的电影文档的详细信息：

{"_id"=>BSON::ObjectId('...'), "plot"=>"A young man is accidentally sent
30 years into the past in a time-traveling DeLorean invented by his friend,
Dr. Emmett Brown, and must make sure his high-school-age parents unite
in order to save his own existence.", ...
"title"=>"Back to the Future", ...

如果遇到错误或看不到输出，请确保在 quickstart.rb文件中指定了正确的连接字符串并加载了示例数据。