コマンドラインから Compass を起動
Compass セッションはコマンドラインから開始できます。
エンタープライズ環境で、スクリプトを使って起動する場合に Compass の配置を簡素化できます。たとえば、機密システムへのアクセスを制限するには、Compass をジャンプ ホスト上で実行できるようにコマンドラインでの起動を構成できます。
コマンドラインから Compass を起動する方法は次の 2 通りあります。
接続文字列に機密情報が含まれている場合は、その情報がコマンドラインに表示されないように構成ファイルを使用するとよいでしょう。
Compass 実行可能ファイルの場所
Compass 実行可能ファイルの名前と場所は、オペレーティング システムによって異なります。
オペレーティング システム | 実行ファイル名 | ロケーション | |
---|---|---|---|
Linux | mongodb-compass | このファイルは /usr/bin ディレクトリにインストールされます。 | |
Windows | MongoDBCompass.exe | このファイルは、インストール プロセス中に選択したフォルダーにインストールされます。 | |
MacOS | MongoDB Compass | このファイルは、アプリケーション フォルダーの下にインストールされます。
|
コマンドライン接続の仕様
Compass のコマンドライン呼び出しには、Compass 実行可能ファイルへのパスと接続文字列の 2 つのコンポーネントがあります。任意で、コマンドラインまたは構成ファイルでユーザー名とパスワードを指定できます。形式は次のとおりです。
<path/to/compass/executable> <connection string> --username <username> --password <password>
注意
ユーザー名とパスワードの引数が指定されていない場合、Compass は接続文字列の認証情報を使用します。
基本的な接続文字列
次の例では、MongoDB University 訓練クラスターに基本的な接続文字列を使用しています。MongoDB インストールに接続するために接続の詳細を次のように変更します。
mongodb-compass mongodb+srv://cluster0.xxxxxx.mongodb.net/library
ユーザー名とパスワードのパラメーター
以下の例では、username
とpassword
パラメーターを使用して、接続文字列で指定された MongoDB 配置に対して Compass を認証しています。
mongodb-compass mongodb+srv://cluster0.xxxxxx.mongodb.net/library --username user1 --password password1
構成ファイル接続の仕様
Compass のコマンドライン呼び出しでは、構成ファイルを指定できます。
形式は次のとおりです。
<path/to/compass/executable> \ --file=<filename> \ [--passphrase=<passphrase>] \ [<connection id>]
コマンド呼び出しのコンポーネントは次のとおりです。
Compass 実行可能ファイルへのパス
接続構成ファイル
接続構成ファイルの任意のパスフレーズ
任意の接続 ID
接続構成ファイルを作成するには、手順に従って、Compass インスタンスから接続の詳細をエクスポートします。エクスポート プロセスにより、お気に入りの接続がすべて含まれるファイルが作成されます。
重要
パスフレーズを使用せずに保存した接続をエクスポートすると、構成ファイルに含まれるのは、ユーザー名とパスワードのプレーンテキスト バージョンです。パスフレーズを使用してパスワードを暗号化します。
MongoDB Compass を開いて MongoDB インスタンスに接続するには、次のようなコマンドラインを使用します。
mongodb-compass --file=learningConnectionFile \ --passphrase=superSecret
お気に入りが複数ある場合は、使用する接続を指定するために構成ファイルの接続 ID を含めます。
mongodb-compass --file=multipleConnectionFile \ --passphrase=superSecret \ 27ba0eda-c27e-46f5-a74a-2c041b1b58c4