Make the MongoDB docs better! We value your opinion. Share your feedback for a chance to win $100.
Click here >
Docs Menu
Docs Home
/ /
管理
Docs Home
/
開発
/
データベース コマンド
/
管理
Docs Home
/
開発
/
データベース コマンド
/
管理

listDatabases（データベースコマンド）

定義

listDatabases

listDatabases コマンドは、既存のすべてのデータベースのソートされていないリストと、各データベースに関する基本的な統計情報を返します。adminデータベースに対して listDatabases コマンドを実行する必要があります。

互換性

このコマンドは、次の環境でホストされている配置で使用できます。

  • MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです

注意

このコマンドは、すべての MongoDB Atlas クラスターでサポートされています。すべてのコマンドに対する Atlas のサポートについては、「サポートされていないコマンド」を参照してください。

  • MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

  • MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

構文

db.adminCommand(
   {
     listDatabases: 1
   }
)

値（例、1）は、コマンドの出力には影響しません。

コマンドフィールド

コマンドは以下の任意フィールドを取ることができます。

フィールド
タイプ
説明

filter

ドキュメント

任意。どのデータベースをリストアップするかを決定するクエリ述語。

listDatabases の出力内の任意のフィールドに条件を指定できます。

  • name

  • sizeOnDisk

  • empty

  • shards

nameOnly

ブール値

任意。コマンドがデータベース名だけを返すか、データベース名とサイズ情報の両方を返すかを示します。

デフォルトは false であるため、listDatabases は各データベースの名前とサイズ情報を返します。

authorizedDatabases

ブール値

任意。アクセス制御を可能にする場合に特権に基づいて返されるデータベースを決定するフラグ。

  • authorizedDatabasesが指定されていない場合、

    • listDatabasesユーザーがクラスターリソースに対して アクションを持っている場合、listDatabases コマンドはすべてのデータベースを返します。

    • ユーザーがクラスターでlistDatabases アクションを実行していない場合、listDatabases はユーザーが特権を持つデータベースのみを返します（ユーザーが特定のコレクションに対して特権を持つデータベースを含む）。

  • authorizedDatabasesがtrue の場合、listDatabases はユーザーが特権を持つデータベースのみを返します（ユーザーが特定のコレクションに対して特権を持つデータベースを含む）。

  • authorizedDatabasesがfalse場合、

    • listDatabasesユーザーがクラスターに対して アクションを持っている場合、listDatabases コマンドはすべてのデータベースを返します

    • listDatabasesユーザーがクラスターで アクションを実行していない場合、権限が十分でないとlistDatabases コマンドはエラーになります。

詳しくは、「 動作 」を参照してください。

comment

any

任意。このコマンドに添付するユーザー指定のコメント。設定すると、このコメントは以下の場所にこのコマンドの記録と合わせて表示されます。

コメントには、有効な BSON 型（string, integer, object, array など）を使用できます。

動作

認証が有効になっている場合、listDatabases はユーザーの特権と オプションに基づいて異なる結果を返します。authorizedDatabases

  • authorizedDatabasesが指定されていない場合、

    • ユーザーがクラスターリソースに対してlistDatabasesアクションを持っている場合、 listDatabasesコマンドはすべてのデータベースを返します。

    • ユーザーがクラスターでlistDatabasesアクションを実行していない場合、 listDatabasesコマンドは、ユーザーが特権を持つデータベースのみを返します（ユーザーが特定のコレクションに対して特権を持つデータベースを含む）。

  • authorizedDatabasesがtrueの場合、 listDatabasesコマンドは、ユーザーが特権を持つデータベースのみを返します（ユーザーが特定のコレクションに対して特権を持つデータベースを含む）。

  • authorizedDatabasesがfalse場合、

    • ユーザーがクラスターに対してlistDatabasesアクションを持っている場合、 listDatabasesコマンドはすべてのデータベースを返します

    • ユーザーがクラスターでlistDatabasesアクションを実行していない場合、権限が十分でないとlistDatabasesコマンドはエラーとなります。

クライアントの切断

操作が完了する前にlistDatabasesを発行したクライアントが切断された場合、MongoDB はlistDatabasesをkillOpを使用して終了対象としてマークします。

レプリカセット ノードの状態の制限

レプリカセット ノード上で listDatabases 操作を実行するには、ノードが PRIMARY または SECONDARY状態である必要があります。ノードが STARTUP2 などの別の状態にある場合、操作はエラーになります。

例

データベース名とサイズを一覧表示する

adminデータベースに対して listDatabases を実行します。

db.adminCommand( { listDatabases: 1 } )

出力例:

{
   "databases" : [
      {
         "name" : "admin",
         "sizeOnDisk" : 83886080,
         "empty" : false
      },
      {
         "name" : "local",
         "sizeOnDisk" : 83886080,
         "empty" : false
      },
      {
         "name" : "test",
         "sizeOnDisk" : 83886080,
         "empty" : false
      }
   ],
   "totalSize" : 251658240,
   "totalSizeMb" : 251,
   "ok" : 1
}

データベース名のみを一覧表示

adminデータベースに対して listDatabases を実行します。nameOnly: true オプションを指定します。

db.adminCommand( { listDatabases: 1, nameOnly: true} )

出力例:

{
   "databases" : [
      {
         "name" : "admin"
      },
      {
         "name" : "local"
      },
      {
         "name" : "test"
      }
   ],
   "ok" : 1
}

フィルターに一致するデータベースを一覧表示する

adminデータベースに対して listDatabases を実行します。フィルター条件に一致するデータベースのみを一覧表示するには、 filter オプションを指定します。

例、次のフィルターは、指定されたregular expression と一致する名前を持つデータベースのみを返します。

db.adminCommand( { listDatabases: 1, filter: { "name": /^rep/ } } )

シャーディングされたクラスター

mongosインスタンスに対して実行すると、listDatabases は次のようになります。

  • は、nameOnly: false の場合、各データベースのサマリー document に shards埋め込みドキュメントを追加します。

  • localデータベースを除外します。

shards埋め込みドキュメントの各フィールドは、シャード名をキーとして使用し、データベースのサイズ（バイト単位）を値として使用します。

sizeOnDiskフィールドは、リスト内のデータベース内のすべてのコレクションとインデックスの合計サイズを表します。

以下に例を挙げます。

{
  "databases" : [
    {
      "name" : "admin",
      "sizeOnDisk" : 16384,
      "empty" : false,
      "shards" : {
        "config" : 16384
      }
    },
    {
      "name" : "config",
      "sizeOnDisk" : 176128,
      "empty" : false,
      "shards" : {
        "shard01" : 28672,
        "shard02" : 8192,
        "config" : 139264
      }
    },
    {
      "name" : "test",
      "sizeOnDisk" : 12288,
      "empty" : false,
      "shards" : {
        "shard01" : 12288
      }
    }
  ],
  "totalSize" : 204800,
  "totalSizeMb" : 0,
  "ok" : 1
}

Tip

データベース・コマンドを使用します。

出力

listDatabases.databases

タイプ: 配列

それぞれが1つのデータベースに関する情報を含むドキュメントの配列。

listDatabases.databases.name

タイプ: String

データベースの名前。

listDatabases.databases.sizeOnDisk

型: 整数

ディスク上のデータベースファイルの合計サイズ (バイト単位)。

listDatabases.databases.empty

タイプ: ブール値

データベースが空かどうかを指定します。

listDatabases.databases.shards

タイプ: ドキュメント

shardsドキュメントの各フィールドは、シャード名をキーとして使用し、データベースのサイズ（バイト単位）を値として使用します。

shards nameOnly: falseの場合のみ出力に表示されます。

詳細については、「シャーディングされたクラスター」を参照してください。

listDatabases.totalSize

型: 整数

すべての sizeOnDisk フィールドの合計 (バイト単位)。

listDatabases.totalSizeMb

型: 整数

sizeOnDisk0}フィールドの総和をメガバイトで表したもの。

listDatabases.ok

型: 整数

コマンドの戻り値。値1は成功を示します。

戻る

listCollections

次へ

listIndexes

項目一覧