/ /

/ /

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

定義

バージョン 5.0 で追加

validateDBMetadata

validateDBMetadataコマンドは、データベースまたはコレクションの保存されたメタデータが特定の API バージョン内で有効であるかどうかを確認します。

validateDBMetadata はエラーを報告しますが、エラーを修正する機能はありません。

互換性

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

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

注意

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

MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

構文

このコマンドの構文は、次のとおりです。

db.runCommand(
   {
     validateDBMetadata: 1,
     apiParameters: {
       version: <string>,
       strict: <boolean>,
       deprecationErrors: <boolean>
      },
     db: <string>,
     collection: <string>,
   }
)

コマンドフィールド

このコマンドは、次のフィールドを使用します。

フィールド	タイプ	説明
apiParameters	ドキュメント	すべてのフィールドが必須です。 `version` （ string ）検証する API バージョン。現在は、 `"1"`が唯一のバージョンです。 `strict` （ブール値） `true`の場合、 APIStrictError応答が出力に含まれます。 `deprecationErrors` （ブール値） `true`の場合、 APIDeprecationError応答が出力に含まれます。
`db`	string	任意。検証するデータベースの名前。データベースが指定されていない場合は、すべてのデータベースが検証されます。
`collection`	string	任意。検証するコレクションまたはビューの名前。コレクションまたはビューが指定されていない場合は、 `db`によって指定されたデータベース内のすべてのコレクションが検証されます。データベースが指定されていない場合は、すべてのデータベース内のすべてのコレクションが検証されます。

動作

すべてのデータベース内のすべてのコレクションを検証し、 APIStrictErrorおよびAPIVersionErrorエラー応答を報告します。
```
db.runCommand( {
  validateDBMetadata: 1,
  apiParameters: {
    version: "1",
    strict: true,
    deprecationErrors: true
  },
})
```
inventoryのすべてのコレクションを検証します。
```
db.runCommand( {
  validateDBMetadata: 1,
  apiParameters: {
    version: "1",
    strict: true,
    deprecationErrors: true
  },
  db: "inventory",
})
```
inventoryデータベース内のsalesコレクションを検証します。
```
db.runCommand( {
  validateDBMetadata: 1,
  apiParameters: {
    version: "1",
    strict: true,
    deprecationErrors: true
  },
  db: "inventory",
  collection: "sales",
})
```
すべてのデータベースにわたる任意の 60 salesコレクションを検証します。
```
db.runCommand( {
  validateDBMetadata: 1,
  apiParameters: {
    version: "1",
    strict: true,
    deprecationErrors: true
  },
  collection: "sales",
})
```

注意

ユーザーは、検証するすべてのコレクションに対してvalidate特権アクションを持っている必要があります。

出力

{
   apiVersionErrors: [
     {
       ns: <string>,
       code: <int>,
       codeName: <string>,
       errmsg: <string>
     }
   ],
   ok: <int>,
   hasMoreErrors: <boolean>,
}

validateDBMetadata.apiVersionErrors: API バージョンエラーを説明するドキュメントの配列。

validateDBMetadata.apiVersionErrors[n].ns: エラーが発生したコレクションまたはビューの名前空間。

validateDBMetadata.apiVersionErrors[n].code: 数値エラーコード。

validateDBMetadata.apiVersionErrors[n].codeName: エラーコードの名前。

validateDBMetadata.apiVersionErrors[n].errmsg: エラーを説明する string。

validateDBMetadata.ok: コマンドが失敗した場合、 okは1に設定されます。それ以外の場合、 okは0に設定されます。 validateDBMetadata.okの値が0であっても検証エラーが報告される場合があります。

validateDBMetadata.hasMoreErrors: trueの場合、追加のエラーが発生します。

例

サンプルクエリ API コードを使用して、 mongoshにsalesコレクションを作成します。

db.sales.insertMany([
    { "_id" : 1, "item" : "shoes", "price" : 10, "quantity" : 2, "date" : ISODate("2021-01-01T08:00:00Z") },
    { "_id" : 2, "item" : "hat", "price" : 20, "quantity" : 1, "date" : ISODate("2021-02-03T09:00:00Z") },
    { "_id" : 3, "item" : "gloves", "price" : 5, "quantity" : 5, "date" : ISODate("2021-02-03T09:05:00Z") },
    { "_id" : 4, "item" : "pants", "price" : 10, "quantity" : 10, "date" : ISODate("2021-02-15T08:00:00Z") },
    { "_id" : 5, "item" : "socks", "price" : 5, "quantity" : 10, "date" : ISODate("2021-02-15T09:05:00Z") },
    { "_id" : 6, "item" : "shirt", "price" : 5, "quantity" : 5, "date" : ISODate("2021-02-15T12:05:10Z") },
    { "_id" : 7, "item" : "belt", "price" : 5, "quantity" : 10, "date" : ISODate("2021-02-15T14:12:12Z") },
    { "_id" : 8, "item" : "blouse", "price" : 10, "quantity" : 5, "date" : ISODate("2021-03-16T20:20:13Z") }
])

itemフィールドにテキストインデックスを追加します。

db.sales.createIndex( { item: "text" } )

API バージョン 1 に厳密に準拠しているかどうかを確認し、出力にsales deprecationErrorsを含めるようにします。

db.runCommand( {
  validateDBMetadata: 1,
  apiParameters: {
    version: "1",
    strict: true,
    deprecationErrors: true
  },
  collection: "sales",
})

validateDBMetadataはitem_textインデックスのAPIStrictErrorを報告します。

{
   apiVersionErrors: [
     {
       ns: 'test.sales',
       code: 323,
       codeName: 'APIStrictError',
       errmsg: 'The index with name item_text is not allowed in API version 1.'
     }
   ],
   ok: 1,
   hasMoreErrors: false,
}

戻る

validate

whatsmyuri