Локализованное руководство по чтению

azure-cosmos-db-pyНазначение, использование и источник

Создавайте NoSQL-сервисы Azure Cosmos DB с помощьюPython/FastAPIСледуя шаблонам производственного уровня. Используйте при реализации настройки клиента базы данных с двойной аутентификацией (DefaultAzureCredential + эмулятор), классов уровня сервисов с операциями CRUD, стратегий ключей разделов, параметризованных запросов или шаблонов TDD для Cosmos. Срабатывает на фразы типа "Cosmos DB", "база данных NoSQL", "хранилище документов", "добавить персистентность", "уровень сервисов базы данных" или "Python Cosmos SDK".

Источник получен: 2026-10-29

Репозиторий-источник: microsoft/skills
SKILL.md: .github/plugins/azure-sdk-python/skills/azure-cosmos-db-py/SKILL.md
Звёзды репозитория: 3,157
Последнее обновление репозитория: 2026-10-31
Категории Skills: Облачные сервисы
Время последнего сбора: 2026-10-31 10:38 UTC+08:00

Лицензия: MIT

Оригинальный файл SKILL.md

Приведенные фрагменты описания рабочих процессов являются вспомогательными средствами для чтения, а не исполняемыми инструкциями от Codez. Для создания этой страницы не использовались сторонние инструменты.

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

Что делает этот навык

Как работает рабочий процесс на вышестоящем уровне

Реализация сервиса Cosmos DB

Создавайте готовые к использованию в производственной среде NoSQL-сервисы Azure Cosmos DB, придерживаясь принципов чистого кода, лучших практик безопасности и разработки через тестирование (TDD).

проход вверх по течению · L11 ↗

Аутентификация и жизненный цикл

> 🔑 К каждому приведенному ниже примеру кода применяются два правила: > >1Это работает локально (Azure CLI / VS Code / Developer CLI) и в Azure (управляемое удостоверение, удостоверение рабочей нагрузки) без изменения кода.

проход вверх по течению · L32 ↗

2Иерархия пидантических моделей

Для четкого разделения используйте пятиуровневую модель:

проход вверх по течению · L141 ↗

Требования и настройка

1Настройка клиентского модуля

Создайте единственный клиент Cosmos с двойной аутентификацией: Полная реализация: См.references/client-setup.md

проход вверх по течению · L104 ↗

Требования безопасности

Аутентификация RBAC: использованиеDefaultAzureCredentialВ Azure — никогда не храните ключи в коде. Ключи только для эмулятора: жестко закодируйте общеизвестный ключ эмулятора только для локальной разработки.

проход вверх по течению · L183 ↗

проход вверх по течению · bash ↗

pip install azure-cosmos azure-identity

Ограничения и проверки качества

Безопасность

Отсутствие секретов в коде (RBAC через DefaultAzureCredential). Параметризованные запросы предотвращают внедрение зависимостей.

проход вверх по течению · L254 ↗

Начните с безопасного пробного периода.

Проверьте поддерживаемый хост и инструкции по установке репозитория. Храните каталог Skill, а также связанные с ним скрипты, ресурсы и документацию вместе;SKILL.mdВ одиночку можно опустить зависимости.
Предоставьте агенту ваши реальные входные данные, желаемый результат и критерии приемки. Синтаксис вызова и доступные инструменты зависят от хоста; данный сайт не предполагает универсальной команды установки.
Попробуйте запустить исходный рабочий процесс в тестовом проекте или в его копии. Перед тем как разрешить операции, изменяющие файлы, удаленные сервисы или оплачиваемые ресурсы, проверьте их.
Проверьте выходные данные на соответствие исходным проверкам качества и вашим собственным требованиям. Успешный запуск или большое количество звезд в репозитории не гарантируют корректного результата.

Формат навыков и спецификация каталога ↗

Подробнее читайте в источнике.

Перевод и сфера применения

В этом руководстве по чтению представлены избранные отрывки из закрепленного текста выше по течению.SKILL.mdПеревод выполнен с помощью переводчика. Это не полное руководство и не гарантия проверенной совместимости. Перед использованием ознакомьтесь с оригиналом и указанными в нем файлами.

Данное введение относится к закрепленной ниже версии; текущая активность в репозитории и время сбора данных отображаются отдельно.

Закрепленный источник: Прочитайте оригинал ↗
Источник получен: 2026-10-29T09:32:23Z
Исходный коммит: 00d66a64919edca5bca2c673373444e36a4b5461
Исходный SHA-256: 3dd01706390b4b1765ae1a7b3829878c4d0ba8485228f824e817287c4f8990d4

Вернуться к полному каталогу навыков