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