Mongoシェルで全ユーザーを一覧表示する方法【getUsers()とshow users】

Mongoシェルでユーザーを一覧表示する2つの方法

MongoDBのシェルで、登録済みのすべてのユーザーを確認したい場合は、getUsers()メソッドまたはshowコマンドを使用します。どちらの方法でも、ユーザー名・所属データベース・ロール・認証メカニズムなどの詳細情報を簡単に取得できます。

方法1：getUsers()メソッドを使う

現在接続しているデータベースに属する全ユーザーの情報を、配列形式で取得するメソッドです。スクリプト内でプログラム的にユーザー情報を扱いたい場合にも便利です。

db.getUsers();

方法2：showコマンドを使う

Mongoシェルが提供するヘルパーコマンドで、対話的に手軽にユーザー一覧を表示できます。コマンド入力の手間が少なく、日常的な確認作業に向いています。

show users;

実際の実行例

それでは、上記の2つの構文を実際に実行し、Mongoシェルでユーザー一覧を表示してみましょう。

ケース1：getUsers()メソッドの実行

最初のクエリは以下のとおりです。

> db.getUsers();

実行すると、次のような出力が得られます。

[
    {
      "_id" : "test.John",
      "user" : "John",
      "db" : "test",
      "roles" : [
          {
            "role" : "readWrite",
            "db" : "test"
          },
          {
            "role" : "dbAdmin",
            "db" : "test"
          }
      ],
      "mechanisms" : [
          "SCRAM-SHA-1",
          "SCRAM-SHA-256"
      ]
    },
    {
      "_id" : "test.admin",
      "user" : "admin",
      "db" : "test",
      "roles" : [
          {
            "role" : "root",
            "db" : "admin"
          }
      ],
      "mechanisms" : [
          "SCRAM-SHA-1",
          "SCRAM-SHA-256"
      ]
    }
]

出力からは、ユーザーごとの_id（ユーザー名とデータベース）、roles（readWriteやdbAdmin、rootなどの権限）、そしてmechanisms（SCRAM-SHA-1 / SCRAM-SHA-256といった認証方式）が確認できます。

ケース2：showコマンドの実行

次に、2つ目の方法であるshowコマンドを実行します。

> show users;

この場合も、同様にユーザー情報が出力されます。

{
    "_id" : "test.John",
    "user" : "John",
    "db" : "test",
    "roles" : [
       {
           "role" : "readWrite",
           "db" : "test"
       },
       {
           "role" : "dbAdmin",
           "db" : "test"
       }
    ],
    "mechanisms" : [
       "SCRAM-SHA-1",
       "SCRAM-SHA-256"
    ]
}
{
    "_id" : "test.admin",
    "user" : "admin",
    "db" : "test",
    "roles" : [
       {
           "role" : "root",
           "db" : "admin"
       }
    ],
    "mechanisms" : [
       "SCRAM-SHA-1",
       "SCRAM-SHA-256"
    ]
}

まとめ

Mongoシェルでユーザー一覧を取得するには、以下の2つの方法があります。

• db.getUsers()：JSON形式の配列として取得でき、スクリプトでの利用に適しています。
• show users：シェル上で手軽に確認できるヘルパーコマンドです。

なお、これらのコマンドは現在接続しているデータベースのユーザーのみを対象とします。他のデータベースのユーザーを確認したい場合は、事前にuse データベース名で対象のデータベースに切り替えてから実行してください。また、ユーザー管理系のコマンドを実行するには、適切な権限（userAdminやuserAdminAnyDatabaseなど）を持つユーザーで認証しておく必要があります。