CLI を使用して保存された接続をエクスポートする

項目一覧

このタスクについて

暗号化された保存された接続のエクスポート
手順
例
暗号化されていない保存された接続のエクスポート
手順
例
次のステップ

保存された接続をエクスポートするには、Compass CLIを使用します。保存した接続をインポートしたり、他のワークスペースで自分自身を使用したりできます。

このタスクについて

保存した接続をエクスポートすると、Compass は接続リストを JSON ファイルとしてエクスポートします。

デフォルトでは、保存した接続をエクスポートすると、パスワードはプレーンテキストに含まれます。機密接続情報を保護するには、パスフレーズを使用してエクスポートされたファイルを暗号化します。

暗号化された保存された接続のエクスポート

このセクションでは、暗号化された保存された接続をエクスポートする方法を説明します。エクスポートファイルを暗号化する場合、ユーザーは接続をインポートするための一致するパスフレーズを指定する必要があります。

手順

Compass CLIを使用して暗号化され保存された接続をエクスポートするには、次のコマンドを指定します。

MongoDB Compass 実行可能ファイルへのパス。実行可能ファイルの名前とファイルパスは、オペレーティングシステムによって異なります。
出力ファイルの宛先に設定されている --export-connectionsオプションは、
--passphraseオプションは、出力ファイルの暗号化に使用されるパスフレーズに設定されます。

操作は次のプロトタイプのようになります。

<path-to-Compass-executable> \
--export-connections=<filename> \
--passphrase=<passphrase>

例

この例では、保存された Compass 接続をパス/tmp/compass-connections/favorites-encrypted.jsonのファイルにエクスポートします。エクスポートされたファイルは、パスフレーズabc123で暗号化されます。

MongoDB Compass 実行可能ファイルを含むフォルダーで次のコマンドを実行します。

./MongoDB\ Compass \
--export-connections=/tmp/compass-connections/favorites-encrypted.json \
--passphrase=abc123

注意

実行可能ファイルの名前とファイルパスは、オペレーティングシステムによって異なります。上記のコマンドは macOS 用です。

次の出力が表示されます。

Exporting connections to "/tmp/compass-connections/favorites-encrypted.json" (with passphrase)

結果

エクスポートが完了すると、 /tmp/compass-connections/favorites-encrypted.jsonファイルは次のようになります。

{
  "type": "Compass Connections",
  "version": {
    "$numberInt": "1"
  },
  "connections": [
    {
      "id": "5a92e195-3ef5-49ae-aff6-720af362770d",
      "connectionOptions": {
        "connectionString": "mongodb+srv://jallen@cluster0.ylwlz.mongodb.net/"
      },
      "favorite": {
        "name": "Dochub",
        "color": "color7"
      },
      "lastUsed": {
        "$date": {
          "$numberLong": "1663785601002"
        }
      },
      "connectionSecrets": "AAGRWyDUI+Jbc9GkvSpEZeFtbvSzqtcOpA+1zLi5fma3AISOOVVBJBPqqh/a6VeNyEcf9TdX6aCqSpagXgMAOmmN0XgkJ4wxwBuSZwZH/h1dlgEFYqEG9Oh88e5z"
    },
    {
      "id": "655f3e6e-b13b-4813-8578-50d896bd9240",
      "connectionOptions": {
        "connectionString": "mongodb://localhost:27017/"
      },
      "favorite": {
        "name": "Local Host",
        "color": "color7"
      },
      "lastUsed": {
        "$date": {
          "$numberLong": "1663790327679"
        }
      },
      "connectionSecrets": "AAG63lys6oVtPmCGVs7wYkTCjFU0yXi9rYUYCKuWGNMSNBy4rAZlu06b/qDblON4OBXDJzhPNQ/WKs79veewNw=="
    }
  ]
}

機密接続情報はconnectionSecretsフィールドで暗号化されます。

暗号化されていない保存された接続のエクスポート

このセクションでは、暗号化されていない接続をエクスポートする方法を説明します。エクスポートファイルを暗号化しない場合、データベースのユーザー名とパスワードはプレーンテキストでエクスポートされます。エクスポートされたファイルにアクセスできる他のユーザーがいない場合にのみ、暗号化されていない接続をエクスポートします。

手順

Compass CLIを使用して暗号化され保存された接続をエクスポートするには、次のコマンドを指定します。

MongoDB Compass 実行可能ファイルへのパス。実行可能ファイルの名前とファイルパスは、オペレーティングシステムによって異なります。
出力ファイルの宛先に設定された--export-connectionsオプション。

操作は次のプロトタイプのようになります。

<path-to-Compass-executable> \
--export-connections=<filename>

例

この例では、保存された Compass 接続をパス/tmp/compass-connections/favorites.jsonのファイルにエクスポートします。

MongoDB Compass 実行可能ファイルを含むフォルダーで次のコマンドを実行します。

./MongoDB\ Compass \
--export-connections=/tmp/compass-connections/favorites.json

注意

実行可能ファイルの名前とファイルパスは、オペレーティングシステムによって異なります。上記のコマンドは macOS 用です。

次の出力が表示されます。

Exporting connections to "/tmp/compass-connections/favorites.json" (without passphrase)

結果

エクスポートが完了すると、 /tmp/compass-connections/favorites.jsonファイルは次のようになります。

{
  "type": "Compass Connections",
  "version": {
    "$numberInt": "1"
  },
  "connections": [
    {
      "id": "5a92e195-3ef5-49ae-aff6-720af362770d",
      "connectionOptions": {
        "connectionString": "<connection string>"
      },
      "favorite": {
        "name": "QA Cluster",
        "color": "color7"
      },
      "lastUsed": {
        "$date": {
          "$numberLong": "1663785601002"
        }
      }
    },
    {
      "id": "655f3e6e-b13b-4813-8578-50d896bd9240",
      "connectionOptions": {
        "connectionString": "mongodb://localhost:27017/"
      },
      "favorite": {
        "name": "Local Host",
        "color": "color7"
      },
      "lastUsed": {
        "$date": {
          "$numberLong": "1663790327679"
        }
      }
    }
  ]
}

次のステップ

エクスポートされた接続をインポートする方法については、「 CLI を使用して保存された接続をインポート」を参照してください。

戻る

CLI によるインポート

必要なアクセス権