Rubyドライバーを使い始める

依存関係のインストール

開発を開始する前に、開発環境にRubyバージョン 2.7 以降をインストールしていることを確認してください。Rubyは macOS および一部のLinuxディストリビューションにプレインストールされていますが、バージョンを更新する必要がある場合があります。

プロジェクト ディレクトリの作成

シェルで次のコマンドを実行して、このプロジェクト用に 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ドライバーを依存関係として追加します。

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

Atlas で無料の MongoDB 配置を作成

Atlas の使用開始ガイドを完了して、新しい Atlas アカウントを設定し、サンプル データを新しい無料階層 MongoDB 配置にロードします。

認証情報を保存する

データベースユーザーを作成したら、そのユーザーのユーザー名とパスワードを安全な場所に保存して、後の手順で使用します。

MongoDB Atlas 接続文字列を見つける

前のステップで作成した配置の接続文字列を取得するには、Atlas アカウントにログして「Clusters」セクションに移動します。次に、新しい配置の Connect ボタンをクリックします。

Connect your application セクションに進みます。Driver 選択メニューから「Ruby」を選択し、Version 選択メニューからインストール済みバージョンに最適なバージョンを選択します。

接続stringのコピー

次のスクリーンショットに示すように、接続文字列の右側にあるコピーボタンをクリックして、クリップボードにコピーします。

プレースホルダーを更新します

この接続stringをテキストエディタのファイルに貼り付け、<db_username> と <db_password> のプレースホルダーをデータベースユーザーのユーザー名とパスワードに置き換えます。

このファイルを安全な場所に保存して、次の手順で使用します。

Rubyアプリケーションファイルを編集する

ruby-quickstartディレクトリ内の quickstart.rbファイルに移動します。このチュートリアルの「ダウンロードとインストール」ステップから次のコードをコピーして、Bunder コードの下に貼り付けます。このコードは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ディレクトリから、次のシェルコマンドを実行してアプリケーションを実行します。

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ファイルに正しい接続文字列が指定されており、サンプルデータがロードされていることを確認してください。