mongofiles

Synopsis

mongofilesユーティリティを使用すると、コマンドラインからGridFSオブジェクト内のMongoDBインスタンスに保存されているファイルを操作できるようになります。これは、ファイルシステムに保存されているオブジェクトとGridFS間のインターフェースを提供するため、特に便利です。

mongofilesシェルではなく、 システムコマンドラインからmongo を実行します。

互換性

インストール

mongofilesツールはMongoDB Database Toolsパッケージの一部です。

➤ Database Toolsインストール ガイド に従って mongofilesをインストールします。

構文

mongofilesコマンドの形式は次のとおりです。

mongofiles <options> <connection-string> <command> <filename or _id>

mongofilesシェルではなく、 システムコマンドラインからmongo を実行します。

mongofiles コマンドのコンポーネントは次のとおりです。

1. オプション。これらのオプションの 1 つ以上を使用して、mongofiles.の動作を制御できます。

2. Connection String。 に接続するmongod /mongos mongofilesの接続文字列。

3. コマンド。これらのコマンドのいずれかを使用して、mongofiles のアクションを決定します。

4. 識別子は、ローカル ファイル システム上のファイルの名前、または GridFS オブジェクトのいずれかです。

必要なアクセス権

mongodオプションを使用して認可を適用する--auth に接続するには、--username オプションと--password オプションを使用する必要があります。接続ユーザーは、少なくとも以下を備えている必要があります。

• 、 、または readコマンドを使用する場合、アクセスしたデータベースのlist ロールsearchget

• または readWriteコマンドを使用する場合、アクセスしたデータベースのputdelete ロール。

動作

オプション

--help

mongofilesのオプションと使用に関する情報を返します。

--verbose, -v

標準出力またはログファイルに返される内部レポートの量が増えます。-v フォームでの冗長性を高めるには、オプションを複数回含めてください（例: -vvvvv）。

--quiet

mongofiles出力量を制限するクワイエットモードで を実行します。

このオプションにより次の項目が抑制されます。

• データベース コマンド からの出力

• レプリケーション アクティビティ

• 接続を受け付けたイベント

• 接続を終了したイベント

--version

mongofilesのリリース番号を返します。

--config=<filename>

バージョン100.3.0の新機能。

次のmongofiles オプションの機密値を含む YAML構成ファイルへのフル パスを指定します。

• --password

• --uri

• --sslPEMKeyPassword

パスワードmongofiles プロンプトを使用して指定する方法以外で、 にパスワードを指定する推奨方法です。ファイルでは、引数を任意に組み合わせて使用できます。

構成ファイルは以下の形式をとります。

password: <password>
uri: mongodb://mongodb0.example.com:27017
sslPEMKeyPassword: <password>

passworduriを指定せずに オプションを指定する場合は、mongofiles コマンドラインオプション（--username や--host など）を使用して、接続文字列の他のコンポーネントを指定できます。

このファイルは、必ず適切なファイルシステム権限で保護してください。

重要

--config オプションを使用する際には、次の制限事項と動作にご注意ください。

• passwordフィールドを指定し、競合するパスワードを含む接続文字列をuriフィールドに指定した場合、mongorestoreはエラーをスローします。

• --configを使用して構成ファイルを指定し、さらに--password、--uri、または--sslPEMKeyPassword mongofilesコマンドラインオプションを使用すると、コマンドラインオプションによって対応する構成ファイルオプションがオーバーライドされます。

--uri=<connectionString>

MongoDB 配置の解決可能な URI 接続文字列 を引用符で囲んで指定します。

--uri="mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][/[database][?options]]"

のバージョン100.0 mongofiles以降では、 オプションを使用せずに、接続文字列を位置指定パラメータとして提供することもできます。--uri

mongofiles mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][/[database][?options]]

接続文字列は、位置指定パラメータとして mongodb:// または mongodb+srv:// で始まっている限り、コマンドラインの任意の点で指定できます。以下に例を挙げます。

mongofiles --username joe --password secret1 mongodb://mongodb0.example.com:27017 --ssl

入力できる接続文字列は 1 つのみです。複数の値を含めようとすると、--uri オプションを使用する場合でも、位置引数として使用する場合でも、エラーになります。

接続文字列のコンポーネントの詳細については、「接続文字列 URI 形式」ドキュメントを参照してください。

注意

connection string 内の一部のコンポーネントは、--username　や --password など、独自の明示的コマンドライン オプションを使用して指定することもできます。明示的オプションを使用中に接続文字列を入力し、競合する情報を指定すると、エラーが発生します。

注意

mongofilesUbuntu. で18 04cannot unmarshal DNSを使用している場合、SRV 接続文字列（mongodb+srv:// 形式）を オプションとともに使用すると、--uri エラー メッセージが表示されることがあります。その場合は、次のいずれかのオプションを代わりに使用します。

• --uri非 SRV接続文字列（ mongodb://形式）と オプション

• 直接接続するホストを指定するための --host オプション

警告

一部のシステムでは、--uri オプションで接続文字列に設定されたパスワードが、他のユーザーによって呼び出される可能性のある ps などのシステム ステータス プログラムに表示される場合があります。そのため、次の代替策を検討しましょう。

• 接続文字列のパスワードを省略し、インタラクティブなパスワード プロンプトを受け取る

• --config オプションを使用して、パスワードを含む構成ファイルを指定します。

--host=<hostname><:port>

mongodGridFSシステムを保持する の解決可能なホスト名を指定します。デフォルトでは、 は、ローカルホストのポート番号mongofiles で実行中MongoDBプロセスに接続しようとします。27017

必要に応じて、27017 以外のポートで実行されている MongoDB インスタンスに接続するためのポート番号を指定します。

あるいは、URI connection string でホスト名を直接指定することもできます。--host を使用中に接続文字列を入力し、競合する情報を指定すると、エラーが発生します。

--port=<port>

デフォルト: 27017

MongoDB インスタンスがクライアント接続のためにリッスンする TCP ポートを指定します。

あるいは、URI connection string でポートを直接指定することもできます。接続文字列を提供すると同時に、--port を使用中に競合する情報を指定すると、エラーが発生します。

--ssl

TLS / SSLmongodmongos サポートが有効になっている または への接続を有効にします。

あるいは、URI connection string で TLS/SSL サポートを直接構成することもできます。--ssl を使用中に接続文字列を入力し、競合する情報を指定すると、エラーが発生します。

TLS/SSL と MongoDB の詳細については、「TLS/SSL 用に mongod と mongos を構成する」と「クライアントの TLS/SSL 構成」を参照してください。

--sslCAFile=<filename>

証明書認証機関からのルート証明書チェーンを含む .pem ファイルを指定します。相対パスまたは絶対パスを使用して .pem ファイルのファイル名を指定します。

あるいは、URI connection string で .pem ファイルを直接指定することもできます。--sslCAFile を使用中に接続文字列を入力し、競合する情報を指定すると、エラーが発生します。

TLS/SSL と MongoDB の詳細については、「TLS/SSL 用に mongod と mongos を構成する」と「クライアントの TLS/SSL 構成」を参照してください。

--sslPEMKeyFile=<filename>

TLS/SSL 証明書とキーの両方を含む .pem ファイルを指定します。相対パスまたは絶対パスを使用して、.pem ファイルのファイル名を指定します。

このオプションは、--ssl オプションを使用して、allowConnectionsWithoutCertificates なしでmongodmongos CAFileが有効になっている または に接続する場合に必要です。

あるいは、URI connection string で .pem ファイルを直接指定することもできます。--sslPEMKeyFile を使用中に接続文字列を入力し、競合する情報を指定すると、エラーが発生します。

TLS/SSL と MongoDB の詳細については、「TLS/SSL 用に mongod と mongos を構成する」と「クライアントの TLS/SSL 構成」を参照してください。

--sslPEMKeyPassword=<value>

証明書鍵ファイルの複合化用パスワード（--sslPEMKeyFile --sslPEMKeyPassword）を指定します。証明書鍵ファイルが暗号化されている場合にのみ、 オプションを使用します。いずれの場合も、mongofiles はすべてのログとレポート出力からパスワードを削除します。

PEMファイル内の秘密キーが暗号化されており、 オプションを指定しない場合は、--sslPEMKeyPassword mongofilesはパスフレーズの入力を要求します。詳細については、「 TLS/SSL 証明書のパスフレーズ 」を参照してください。

あるいは、URI connection string でパスワードを直接指定することもできます。--sslPEMKeyPassword を使用中に接続文字列を入力し、競合する情報を指定すると、エラーが発生します。

TLS/SSL と MongoDB の詳細については、「TLS/SSL 用に mongod と mongos を構成する」と「クライアントの TLS/SSL 構成」を参照してください。

警告

一部のシステムでは、--sslPEMKeyPassword オプションを使用して直接提供されたパスワードは、他のユーザーによって呼び出される可能性のある ps などのシステム ステータス プログラムに表示される場合があります。代わりに --config オプションを使用して、パスワードを含む構成ファイルを指定することを検討してください。

--sslCRLFile=<filename>

証明書失効リストを含む .pem ファイルを指定します。相対パスまたは絶対パスを使用して .pem ファイルのファイル名を指定します。

TLS/SSL と MongoDB の詳細については、「TLS/SSL 用に mongod と mongos を構成する」と「クライアントの TLS/SSL 構成」を参照してください。

--sslAllowInvalidCertificates

サーバー証明書の検証チェックをバイパスし、無効な証明書を使用できるようにします。 設定を使用すると、 MongoDBallowInvalidCertificates は無効な証明書の使用を警告としてログを記録します。

警告

--sslAllowInvalidCertificates オプションは使用可能ですが、可能な限り使用しないでください。--sslAllowInvalidCertificates の使用が必要な場合は、侵入が不可能なシステムでのみこのオプションを使用してください。

mongodサーバー証明書を検証せずに または インスタンスに接続すると、潜在的なセキュリティ上のリスクが発生します。 TLS/SSL 証明書のホスト名の検証を無効にするだけの場合は、 を参照してください。mongos--sslAllowInvalidHostnames

あるいは、URI connection string で証明書の検証を直接無効にすることもできます。接続文字列を提供すると同時に、--sslAllowInvalidCertificates を使用中に競合する情報を指定すると、エラーが発生します。

TLS/SSL と MongoDB の詳細については、「TLS/SSL 用に mongod と mongos を構成する」と「クライアントの TLS/SSL 構成」を参照してください。

--sslAllowInvalidHostnames

TLS/SSL 証明書のホスト名の検証を無効にします。証明書内のホスト名が指定されたホスト名と一致しない場合でも、mongofiles はMongoDBインスタンスに接続できます。

あるいは、URI connection string でホスト名の検証を直接無効にすることもできます。--sslAllowInvalidHostnames を使用中に接続文字列を入力し、競合する情報を指定すると、エラーが発生します。

TLS/SSL と MongoDB の詳細については、「TLS/SSL 用に mongod と mongos を構成する」と「クライアントの TLS/SSL 構成」を参照してください。

--username=<username>, -u=<username>

認証 を使用するMongoDBデータベースへの認証すに使用するユーザー名を指定します。--password および--authenticationDatabase オプションと組み合わせて使用します。

あるいは、URI connection string でユーザー名を直接指定することもできます。--username を使用中に接続文字列を入力し、競合する情報を指定すると、エラーが発生します。

を使用してMongoDB MONGODB-AWSauthentication mechanismAtlasクラスターに接続する場合は、次の場所でAWSアクセスキーID を指定できます。

• このフィールド

• connection string、または

• AWS_ACCESS_KEY_ID 環境変数。

それぞれの例については、「AWS IAM 認証情報を使用して MongoDB Atlas クラスターに接続する」を参照してください。

--password=<password>, -p=<password>

認証 を使用するMongoDBデータベースに対して認証するためのパスワードを指定します。--username および--authenticationDatabase オプションと組み合わせて使用します。

ユーザーにパスワードの入力を求めるには、--username --password--passwordなしで オプションを渡すか、--password "" のように 値として空の文字列を指定します。

あるいは、URI connection string でパスワードを直接指定することもできます。--password を使用中に接続文字列を入力し、競合する情報を指定すると、エラーが発生します。

を使用してMongoDB MONGODB-AWSauthentication mechanismAtlasクラスターに接続する場合は、次の場所でAWSシークレット アクセスキーを指定できます。

• このフィールド

• connection string、または

• AWS_SECRET_ACCESS_KEY 環境変数。

それぞれの例については、「AWS IAM 認証情報を使用して MongoDB Atlas クラスターに接続する」を参照してください。

警告

一部のシステムでは、--password オプションを使用して直接提供されたパスワードは、他のユーザーによって呼び出される可能性のある ps などのシステム ステータス プログラムに表示される場合があります。そのため、次の代替策を検討しましょう。

• --password オプションを省略し、インタラクティブなパスワード プロンプトを表示する

• --config オプションを使用して、パスワードを含む構成ファイルを指定します。

--awsSessionToken=<AWS Session Token>

を使用してMongoDB Atlasクラスターに接続し、 MONGODB-AWSauthentication mechanismAWSアクセスキーIDとシークレットアクセスキーに加えてセッション トークンを使用する場合は、次の場所にAWSセッション トークンを指定できます。

• このフィールド

• AWS_SESSION_TOKENauthMechanismPropertiesパラメータをconnection string に、または

• AWS_SESSION_TOKEN 環境変数。

それぞれの例については、「AWS IAM 認証情報を使用して MongoDB Atlas クラスターに接続する」を参照してください。

MONGODB-AWS authentication mechanism を使用している場合にのみ有効です。

--authenticationDatabase=<dbname>

指定された--username が作成された認証データベースを指定します。詳細については、「 認証データベース 」を参照してください。

GSSAPI（Kerberos）、PLAIN（LDAP SASL）、または MONGODB-AWS authentication mechanisms を使用する場合は、--authenticationDatabase を $externalに設定する必要があります。

あるいは、URI connection string で認証データベースを直接指定することもできます。--authenticationDatabase を使用中に接続文字列を入力し、競合する情報を指定すると、エラーが発生します。

--authenticationMechanism=<name>

デフォルト: SCRAM-SHA-1

mongofilesインスタンスがmongod またはmongos への認証に使用する認証メカニズムを指定します。

バージョン 100.1.0 での変更:

バージョン100.1.0 mongofiles以降、MONGODB-AWS はMongoDB Atlasクラスターに接続するときに 認証メカニズムのサポートを追加します。

値	説明
SCRAM-SHA-1	RFC5802 標準の Salted Challenge Response Authentication Mechanism（SHA-1 ハッシュ関数を使用）。
SCRAM-SHA-256	RFC7677 標準の Salted Challenge Response Authentication Mechanism（SHA-256 ハッシュ関数を使用）。 featureCompatibilityVersion を 4.0 に設定する必要があります。
MONGODB-X.509	MongoDB TLS/SSL 証明書認証。
MONGODB-AWS	MongoDB Atlas クラスターへの接続に使用する AWS IAM 認証情報を使用した外部認証。「AWS IAM 認証情報を使用して MongoDB Atlas クラスターに接続する」を参照してください。 バージョン100.1.0の新機能。
GSSAPI（Kerberos）	Kerberos を使用する外部認証。このメカニズムは MongoDB Enterprise でのみ使用できます。
PLAIN（LDAP SASL）	LDAP を使用する外部認証。データベース内のユーザー認証には、PLAIN を使用することもできます。PLAIN はパスワードをプレーン テキストで送信します。このメカニズムは MongoDB Enterprise でのみ使用できます。

あるいは、URI connection string　で認証メカニズムを直接指定することもできます。--authenticationMechanism を使用中に接続文字列を入力し、競合する情報を指定すると、エラーが発生します。

--gssapiServiceName=<serviceName>

GSSAPI/Kerberos を使用してサービスの名前を指定します。サービスがデフォルト名mongodb を使用しない場合のみ必要となります。

このオプションは MongoDB Enterprise でのみ使用できます。

--gssapiHostName=<hostname>

GSSAPI/Kerberos を使用してサービスのホスト名を指定します。マシンのホスト名が DNS で解決されたホスト名と一致しない場合にのみ必要となります。

このオプションは MongoDB Enterprise でのみ使用できます。

--db=<database>, -d=<database>

mongofilesを実行するデータベースの名前を指定します。

あるいは、URI connection string でデータベースを直接指定することもできます。--db を使用中に接続文字列を入力し、競合する情報を指定すると、エラーが発生します。

--local=<filename>, -l=<filename>

get および put 操作のファイルのローカル ファイル システム名を指定します。

mongofiles put コマンドと mongofiles get コマンドでは、必須の 修飾子は、<filename> GridFS内でオブジェクトが持つ名前を参照します。mongofiles は、これがローカルファイルシステム上のファイル名を反映していると想定します。この設定はデフォルトのを上書きします。

--type=<MIME>

GridFSストレージに挿入されたファイルを記述するためにMIME型を指定する能力を提供します。mongofiles は、デフォルトの操作ではこのオプションを省略します。

mongofiles put 操作でのみ使用してください。

--replace, -r

同じ名前のオブジェクトを追加するのではなく、既存の GridFS オブジェクトを指定されたローカル ファイルに置き換えるように mongofiles put の動作を変更します。

デフォルトの操作では、ファイルは mongofiles put オプションによって上書きされません。

--prefix=<string>

デフォルト: fs

使用する GridFS プレフィックス。

--writeConcern=<document>

デフォルト: 過半数

が実行する各書込み操作の書込み保証 (writemongofiles concern)を指定します。

w オプション適用のドキュメントとしての書込み保証（write concern）の指定

--writeConcern="{w:'majority'}"

書き込み保証が --uri connection string にも含まれている場合、URI文字列で指定された書き込み保証はコマンドライン --writeConcern で上書きされます。

--readPreference=<string|document>

デフォルト:primary

の読み込み設定 (read preference)を指定します。 mongofiles--readPreferenceオプションには次の値を指定できます。

• 読み込み設定 (read preference) モードのみを指定する場合の文字列

  --readPreference=secondary

• モード、オプションの読み込み設定（read preference）タグセット、任意の maxStalenessSeconds を指定するために、次のとおり引用符で囲まれたドキュメント。

  --readPreference='{mode: "secondary", tagSets: [ { "region": "east" } ], maxStalenessSeconds: 120}'

  maxStalenessSeconds を指定する場合、値は90 以上である必要があります。

mongofilesprimaryはデフォルトで 読み込み設定 (read preference)になります。

読み込み設定 (read preference)が にも含まれている場合、コマンドライン は URI string で指定された読み込み設定 (read--uri connection string --readPreferencepreference)を上書きします。

コマンド

list <prefix>

GridFS ストア内のファイルを一覧表示します。list の後に指定された文字（例:<prefix> ）により、返されるアイテムのリストがその文字列で始まるファイルに制限されます。

search <string>

<string> の一部と一致する名前を持つ GridFS ストア内のファイルを一覧表示します。

put <filename1[ filename2] ...>

指定されたファイルをローカル ファイル システムから GridFS ストレージにコピーします。複数のファイルをスペース区切りのリストとして指定できます。

指定された各ファイル名は、 GridFS内でオブジェクトが持つ名前を参照し、mongofiles では、これがローカルファイルシステム上のファイルの名前を反映していると想定されます。ローカル ファイル名が異なる場合は、mongofiles --local オプションを使用します。

get <filename1[ filename2] ...>

指定されたファイルを GridFS ストレージからローカル ファイル システムにコピーします。

指定された各ファイル名により GridFS 内のオブジェクト名が参照されます。このファイル名は、mongofiles によりローカル ファイル システムに書き込みが行われるときに使用されます。

コマンドに 1 つのfilename get--localのみを指定する場合は、必要に応じて オプションを使用して書き込み先の別のローカル ファイル名を指定できます。--local コマンドに複数のfilename を指定する場合、get オプションは使用できません。

注意

正規表現に一致する GridFS ストレージからファイルをコピーするには、代わりに get_regex コマンドを使用します。

get_id "<_id>"

<_id> で指定されたファイルを GridFS ストレージからローカル ファイル システムにコピーします。<_id> は、GridFS 内のオブジェクトの拡張 JSON _id を参照します。get_id は、<_id> の ObjectId 値または非 ObjectId 値のいずれかを受け入れることができます。

mongofilesは、 GridFS内のファイル名を使用してローカルファイルシステムにファイルを書き込みます。ローカルファイルシステム上のファイルの別の場所を選択するには、--local オプションを使用します。

get_regex <regex> --regexOptions <regex-options>

指定された <regex> 式に一致するファイルまたは複数のファイルを GridFS ストレージからローカル ファイル システムにコピーします。get_regex コマンドは、UTF-8 をサポートする Perl 互換正規表現（「PCRE」）バージョン 8.42 を使用します。

オプションで、--regexOptions フラグを使用して 1 つ以上の <regex-options> を指定できます。これらは、大文字と小文字を区別しないなどの設定を含む、$regex 演算子でサポートされているオプションのいずれかになります。複数のオプションは区切り文字なしで一緒に提供する必要があります。例：--regexOptions si

mongofilesは、 GridFS内の各ファイルの一致するファイル名を使用して、ファイルをローカルファイルシステムに書込みます。 コマンドでは --localオプションは使用 できませんget_regex 。

delete <filename>

指定されたファイルを GridFS ストレージから削除します。

delete_id "<_id>"

<_id> で指定されたファイルを GridFS ストレージから削除します。delete_id は、<_id> の ObjectId 値または非 ObjectId 値のいずれかを受け入れることができます。

例

mongofilesシェルではなく、 システムコマンドラインからmongo を実行します。

データベース内のGridFSコレクション内のすべてのファイルのリストを返すには、システムシェルで次の呼び出しを使用します。records

mongofiles -d=records list

このmongofiles インスタンスは、mongod 27017ローカルホスト インターフェースで実行中 インスタンスに接続し、別のポートまたはホスト名で同じ操作を指定して、次のいずれかのようなコマンドを発行します。

mongofiles --port=37017 -d=records list
mongofiles --host=db1.example.net -d=records list
mongofiles --host=db1.example.net --port=37017 -d=records list

mongod異なるポートまたはホスト上の インスタンスを接続する場合は、必要に応じて次のコマンドのいずれかを変更します。

32-corinth.lp という名前のファイルを records データベースの GridFS コレクションにアップロードするには、次のコマンドを使用できます。

mongofiles -d=records put 32-corinth.lp

records データベース内のこの GridFS コレクションから 32-corinth.lp ファイルを削除するには、次のコマンドを使用できます。

mongofiles -d=records delete 32-corinth.lp

records データベースの GridFS コレクションで、名前に文字列 corinth が含まれるファイルを検索するには、次のコマンドを使用できます。

mongofiles -d=records search corinth

records データベース内の GridFS コレクション内の、名前が文字列 32 で始まるすべてのファイルを一覧表示するには、次のコマンドを使用します。

mongofiles -d=records list 32

32-corinth.lp という名前の records データベース内の GridFS コレクションからファイルを取得するには、次のコマンドを使用できます。

mongofiles -d=records get 32-corinth.lp

records データベース内の GridFS コレクションから、名前が文字列 32 で始まり、文字列.lp で終わるすべてのファイルを取得するには、次のコマンドを使用します。

mongofiles -d=records get_regex 32*.lp

_id: ObjectId("56feac751f417d0357e7140f") を使用して records データベースの GridFS コレクションからファイルを取得するには、次のコマンドを使用できます。

mongofiles -d=records get_id '{"$oid": "56feac751f417d0357e7140f"}'

_id の前後に引用符を含める必要があります。

mongofiles 'mongodb+srv://<aws access key id>:<aws secret access key>@cluster0.example.com/testdb?authSource=$external&authMechanism=MONGODB-AWS' <other options>

mongofiles 'mongodb+srv://<aws access key id>:<aws secret access key>@cluster0.example.com/testdb?authSource=$external&authMechanism=MONGODB-AWS&authMechanismProperties=AWS_SESSION_TOKEN:<aws session token>' <other options>

: / ? # [ ] @

mongofiles 'mongodb+srv://cluster0.example.com/testdb?authSource=$external&authMechanism=MONGODB-AWS' --username <aws access key id> --password <aws secret access key> --awsSessionToken <aws session token> <other options>

export AWS_ACCESS_KEY_ID='<aws access key id>'
export AWS_SECRET_ACCESS_KEY='<aws secret access key>'
export AWS_SESSION_TOKEN='<aws session token>'

env | grep AWS

mongofiles 'mongodb+srv://cluster0.example.com/testdb?authSource=$external&authMechanism=MONGODB-AWS'  <other options>