Устранение распространенных проблем в Azure DocumentDB

Это руководство предназначено для решения проблем, которые могут возникнуть при использовании Azure DocumentDB. В этом руководстве представлены решения проблем с подключением, ошибок и задач оптимизации, предлагая практические аналитические сведения для улучшения вашего опыта.

Замечание

Обратите внимание, что эти решения являются общими рекомендациями и могут требовать конкретных конфигураций в зависимости от отдельных ситуаций. Всегда обращайтесь к официальной документации и ресурсам поддержки для получения наиболее точной и актуальной информации.

Распространенные ошибки и способы их устранения

Не удается подключиться к Azure DocumentDB — ошибка времени ожидания

Эта проблема может возникать, если кластер не включает правильные правила брандмауэра. Если вы пытаетесь получить доступ к кластеру из диапазона IP-адресов, отличных от Azure, необходимо добавить дополнительные правила брандмауэра. Подробные инструкции см. в разделе "Параметры безопасности" и функции Azure DocumentDB . Правила брандмауэра можно настроить в параметре сети портала для кластера. К параметрам относятся добавление известного IP-адреса или диапазона или включение доступа к общедоступному IP-адресу.

Не удалось подключиться из-за ошибки DNSClient.DnsResponseException

Проблемы с отладкой подключения:

Пользователь Windows:
PsPing не работает. Использование nslookup подтверждает доступность кластера и возможность обнаружения, указывая, что проблемы с сетью вряд ли возникают.

Пользователи Unix:
Для ошибок, связанных с сокетами или сетью, потенциальные проблемы с сетевым подключением могут мешать приложению установить соединение с конечной точкой Azure DocumentDB Mongo API.

Чтобы проверить подключение, выполните следующие действия.

nc -v <accountName>.mongocluster.cosmos.azure.com 10260

Если tcp-подключение к порту 10260 завершается ошибкой, брандмауэр среды может блокировать подключение к Azure DocumentDB. Доброжелательно прокрутите вниз до нижней части страницы, чтобы отправить запрос в службу поддержки.

Проверьте строку подключения:

Используйте только строку подключения, указанную на портале Azure. Убедитесь, что он включает протокол mongodb+srv://, так как это необходимо для правильного подключения. Избегайте использования любых вариантов или префиксов, таких как c. Если возникают проблемы с подключением, поделитесь журналами драйверов на стороне клиента или приложения для отладки, отправив запрос в службу поддержки.

Коды ошибок

В этой таблице перечислены коды ошибок, возвращаемые Azure DocumentDB для выявления и устранения проблем. Это также полезно для устранения неполадок с помощью журналов диагностики.

Код ошибки	Имя ошибки
1	Внутренняя ошибка
2	BadValue
5	ГрафСодержитЦикл
9	Не удалось выполнить синтаксический анализ
14	TypeMismatch
15	Overflow
20	Недопустимая операция
23	Уже инициализировано
26	NamespaceNotFound
двадцать семь	ИндексНеНайден
28	ПутьНедостижим
31	RoleNotFound (Роль не найдена)
34	Не удается заполнить массив
40	КонфликтующиеОператорыОбновления
43	CursorNotFound
48	NamespaceExists
52	DollarPrefixedFieldName
53	CanNotBeTypeArray
54	ПолеНеОдинарногоЗначения
56	ПустоеИмяПоля
57	DottedFieldName
61	ShardKeyNotFound (Ключ-шард не найден)
66	Неизменяемое Поле
67	Не удается создать индекс
68	ИндексУжеСуществует
72	Недопустимые параметры
73	Недопустимое пространствоname
85	КонфликтПараметровИндекса
86	Конфликт ключевых спецификаций индекса
111	NotExactValueField
115	КомандаНеПоддерживается
118	NamespaceNotSharded
146	Превышен лимит памяти
159	ПереполнениеДлительности
165	Превышено ограничение глубины представления
166	КомандаНеПоддерживаетсяНаПросмотре
167	OptionNotSupportedOnView
181	НеоднозначныйШаблонКлючаИндекса
197	НевернаяОпцияСпецификацииИндекса
224	ЗапросФункцииЗапрещен
232	МаксимальнаяГлубинаПодпайплайнаПревышена
241	Сбой преобразования (ConversionFailure)
263	ОперацияНеПоддерживаетсяВТранзакции
276	СтроительствоИндексаПрервано
291	Не удается найти индекс
361	CollectionUUIDMismatch
10334	BsonObjectTooLarge
11000	Повторяющийся ключ
12587	Фоновая операция выполняется для пространства имен
13113	ЭтапОбъединенияНетСоответствующегоДокумента
13297	DbAlreadyExists

Дальнейшие шаги

• Если вы выполнили все действия по устранению неполадок и по-прежнему не удается устранить проблему, вы можете открыть запрос на поддержку для дальнейшей помощи.
• Если вы устраняете неполадки с репликацией между регионами, ознакомьтесь с руководством по устранению неполадок для репликации между регионами.