Ruby驱动程序入门

安装依赖项

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

创建项目目录

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

mkdir ruby-quickstart

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

cd ruby-quickstart
touch quickstart.rb

将Ruby驾驶员添加到项目中

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

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

此代码使用Bundler依赖项管理工具将Ruby驾驶员添加为依赖项。

在 Atlas 上创建免费的 MongoDB 部署

请按照 Atlas 入门指南中的步骤，设置新的 Atlas 账户并将示例数据加载到新的免费套餐 MongoDB 部署中。

保存您的档案

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

查找 MongoDB Atlas 连接字符串

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

继续执行 Connect your application 部分。从 Driver 选择菜单中选择“Ruby”，然后从 Version 选择菜单中选择与您已安装版本最匹配的版本。

复制连接字符串

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

更新占位符

将此连接字符串粘贴到您首选文本编辑器中的文件中，并将<db_username>和<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> 占位符替换为从本教程的创建连接字符串步骤中复制的连接字符串。

运行Ruby应用程序

在 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文件中指定了正确的连接字符串并加载了示例数据。