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配置を作成します。

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

認証情報を保存します。

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

MongoDB Atlas接続文字列を見つけます。

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

データベースユーザーをまだ設定していない場合、 MongoDB は新しいユーザーを作成して設定するように要求します。

Connect to your application セクションの下の Drivers ボタンをクリックし、Driver 選択メニューから「Ruby」を選択し、Version 選択メニューからインストールしたバージョンに最適なバージョンを選択します。

接続文字列のみを表示するには、View full code sample オプションが選択されていないことを確認します。

接続文字列をコピーします。

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

パスワード プレースホルダーを更新します。

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