適用対象: 
MongoDB 仮想コア
このガイドは、Azure Cosmos DB for MongoDB 仮想コアを使用するときに発生する可能性のある問題の解決に役立ちます。 このガイドでは、接続の問題、エラー シナリオ、最適化の課題に対する解決策を提示し、エクスペリエンスを向上させるための実用的な分析情報を提供します。
注
これらの解決策は一般的なガイドラインであり、個々の状況に応じて特定の構成が必要になる場合があることに注意してください。 最も正確で最新の情報については、常に公式ドキュメントとサポート リソースを参照してください。
一般的なエラーと解決
Azure Cosmos DB for MongoDB 仮想コアに接続できない - タイムアウト エラー
この問題は、クラスターで正しいファイアウォール規則が有効になっていない場合に発生する可能性があります。 Azure 以外の IP 範囲からクラスターにアクセスしようとしている場合は、別のファイアウォール規則を追加する必要があります。 詳細な手順については、「セキュリティ オプションと機能 - Azure Cosmos DB for MongoDB 仮想コア」を参照してください。 ファイアウォール規則は、クラスターのポータルの [ネットワーク] 設定で構成できます。 オプションには、既知の IP アドレス/範囲の追加やパブリック IP アクセスの有効化が含まれます。
DNSClient.DnsResponseException エラーで接続できない
接続の問題のデバッグ:
Windows ユーザー:
PsPing が機能しません。 nslookup を使用すると、クラスターの到達可能性と探索可能性が確認され、ネットワークの問題が発生する可能性が低いことがわかります。
Unix ユーザー:
ソケット/ネットワーク関連の例外の場合、ネットワーク接続の潜在的な問題により、アプリケーションが Azure Cosmos DB Mongo API エンドポイントとの接続を確立できていない可能性があります。
接続をチェックするには、次の手順に従います。
nc -v <accountName>.mongocluster.cosmos.azure.com 10260
ポート 10260 への TCP 接続が失敗した場合は、環境ファイアウォールが Azure Cosmos DB 接続をブロックしている可能性があります。 ページの下部まで下にスクロールして、サポート チケットを送信してください。
接続文字列を確認する:
Azure portal で提供されている接続文字列のみを使用します。 適切な接続には mongodb+srv:// プロトコルが必要なため、これが含まれていることを確認します。 バリエーションや「c.」などのプレフィックスは使わないでください。 接続に関する問題が発生する場合は、サポート チケットを送信して、デバッグ用のアプリケーションまたはクライアント側ドライバー ログを共有してください。
エラー コード
次の表に、問題の特定と解決に役立つ Azure Cosmos DB for MongoDB 仮想コアによって返されるエラー コードを示します。 これらは、 診断ログを使用した問題のトラブルシューティングにも役立ちます。
| エラー コード | エラー名 |
|---|---|
| 1 | 内部エラー |
| 2 | BadValue |
| 5 | グラフはサイクルを含む |
| 9 | 解析に失敗しました |
| 14 | TypeMismatch |
| 15 | オーバーフロー |
| 20 | IllegalOperation |
| 23 | AlreadyInitialized |
| 26 | Namespaceが見つかりません |
| 二十七 | IndexNotFound |
| 28 | PathNotViable |
| 31 | 役割が見つかりません |
| 34 | CannotBackfillArray |
| 40 | ConflictingUpdateOperators |
| 43 | CursorNotFound（カーソルが見つかりません） |
| 48 | NamespaceExists |
| 52 | DollarPrefixedFieldName |
| 53 | CanNotBeTypeArray |
| 54 | NotSingleValueField |
| 56 | EmptyFieldName |
| 五十七 | DottedFieldName |
| 61 | シャードキーが見つかりません |
| 66 | 不変フィールド |
| 67 | インデックスを作成できません |
| 68 | インデックスはすでに存在します |
| 72 | 無効なオプション |
| 73 | 無効な名前空間 |
| 85 | インデックスオプションの競合 |
| 86 | IndexKeySpecsConflict |
| 111 | NotExactValueField |
| 115 | コマンドはサポートされていません |
| 118 | NamespaceNotSharded |
| 146 | メモリ制限超過 |
| 159 | DurationOverflow |
| 165 | 視野深度制限超過 |
| 166 | CommandNotSupportedOnView |
| 167 | ビューでサポートされていないオプション |
| 181 | あいまいなインデックスキーのパターン |
| 197 | InvalidIndexSpecificationOption |
| 224 | クエリ機能は許可されていません |
| 232 | サブパイプラインの深さが上限を超えました |
| 241 | 変換失敗 |
| 263 | トランザクションでサポートされていない操作 |
| 276 | IndexBuildAborted |
| 291 | インデックスを見つけることができません |
| 361 | CollectionUUIDMismatch |
| 10334 | Bsonオブジェクトが大きすぎます |
| 11000 | デュプリケートキー |
| 12587 | ネームスペースでのバックグラウンド操作が進行中 |
| 13,113 | MergeStageNoMatchingDocument |
| 13297 | DbAlreadyExists |
次のステップ
- すべてのトラブルシューティング手順に従っても問題を解決できない場合は、サポート リクエストを開いてサポートを受けることができます。
- リージョン間レプリケーションのトラブルシューティングを行う場合は、「リージョン間レプリケーションのトラブルシューティング ガイド」を参照してください。