Навыки azure-cosmos-db-py
📦

azure-cosmos-db-py

Безопасно

Создание сервисов Azure Cosmos DB с использованием Python

Реализация производственных сервисов Azure Cosmos DB NoSQL с надлежащей аутентификацией, чистой архитектурой и разработкой через тестирование. Этот навык предоставляет шаблоны и паттерны для безопасной интеграции баз данных в приложения FastAPI.

Поддерживает: Claude Codex Code(CC)
📊 71 Адекватно
1

Скачать ZIP навыка

2

Загрузить в Claude

Перейдите в Settings → Capabilities → Skills → Upload skill

3

Включите и начните использовать

Протестировать

Использование «azure-cosmos-db-py». Create a Cosmos DB client module with dual authentication

Ожидаемый результат:

Полный файл cosmos.py с синглтон-функцией get_container(), вспомогательной функцией определения _is_emulator_endpoint() и поддержкой обоих режимов аутентификации - DefaultAzureCredential и ключа эмулятора.

Использование «azure-cosmos-db-py». Build a ProjectService with CRUD operations

Ожидаемый результат:

Сервисный класс с методами get_by_id, create, update и delete, использующий асинхронные обертки, надлежащее преобразование моделей Pydantic и элегантную деградацию с возвратом None при недоступности Cosmos.

Аудит безопасности

Безопасно
v1 • 2/24/2026

All 37 static analysis findings are false positives. The scanned file (SKILL.md) is a documentation file containing code examples in markdown format, not executable code. External command detections are bash examples in documentation blocks. Network and environment variable references are configuration templates for Azure Cosmos DB connectivity. The skill demonstrates proper security practices including RBAC via DefaultAzureCredential, parameterized queries, and secure secret management.

1
Просканировано файлов
245
Проанализировано строк
0
находки
1
Всего аудитов
Проблем безопасности не найдено
Проверено: claude

Оценка качества

38
Архитектура
100
Сопровождаемость
87
Контент
31
Сообщество
100
Безопасность
91
Соответствие спецификации

Что вы можете построить

Бэкенд-разработчик, создающий SaaS-приложение

Реализовать мультитенантное хранение данных с использованием Cosmos DB с изоляцией по ключу секции для каждого рабочего пространства, используя DefaultAzureCredential для безопасного развертывания в production.

DevOps-инженер, настраивающий среду разработки

Настроить локальную разработку с эмулятором Cosmos DB, используя переменные окружения для конфигурации конечной точки и фикстуры для CI/CD-конвейеров.

Решения архитектор, проектирующий облачные приложения

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

Попробуйте эти промпты

Базовый: Настройка клиента Cosmos DB 
Создать модуль клиента Cosmos DB с синглтон-паттерном, который использует DefaultAzureCredential для production и ключ эмулятора для локальной разработки. Включить настройку SSL и инициализацию контейнера.
Средний: Создание сервисного уровня 
Построить сервисный класс для сущности Project с операциями CRUD. Использовать пятиуровневый паттерн моделей Pydantic и реализовать элегантную деградацию при недоступности Cosmos DB.
Продвинутый: Написание параметризованных запросов 
Реализовать SQL-запросы Cosmos DB с использованием синтаксиса @parameter для фильтрации проектов по workspace_id и имени. Включить надлежащую обработку ошибок для CosmosResourceNotFoundError.
Экспертный: Настройка инфраструктуры тестирования 
Создать pytest-фикстуры для мокирования операций контейнера Cosmos DB. Включить примеры асинхронных тестов для методов сервисного уровня с надлежащим мокированием функции get_container.

Лучшие практики

  • Всегда используйте DefaultAzureCredential в production-средах - никогда не хардкодьте ключи или секреты в исходном коде
  • Используйте параметризованные запросы с синтаксисом @parameter для предотвращения SQL-внедрения в запросах Cosmos DB
  • Реализуйте элегантную деградацию, возвращая None или пустые списки при недоступности Cosmos DB вместо выброса исключений

Избегать

  • Хардкод подключения ключей или секретов непосредственно в исходном коде вместо использования переменных окружения или управляемой идентичности
  • Использование конкатенации строк для построения запросов вместо параметризованного синтаксиса запросов с заполнителями @parameter
  • Создание новых экземпляров CosmosClient при каждом запросе вместо использования синглтон-паттерна для объединения подключений

Часто задаваемые вопросы

В чем разница между DefaultAzureCredential и аутентификацией с ключом эмулятора?
DefaultAzureCredential использует управляемую идентичность или учетные данные Azure CLI для production-сред с RBAC. Аутентификация с ключом эмулятора использует известный ключ только для локальной разработки и никогда не должна использоваться в production.
Как обрабатывать недоступность Cosmos DB элегантно?
Реализуйте проверку _use_cosmos() в вашем сервисном уровне, которая возвращает False, когда контейнер равен None. Методы сервиса возвращают None для одиночных элементов или пустые списки для запросов вместо выброса исключений.
Зачем использовать асинхронные обертки для синхронных вызовов Cosmos SDK?
Azure Cosmos DB Python SDK является синхронным. Использование run_in_threadpool из starlette предотвращает блокировку цикла событий FastAPI, сохраняя асинхронные характеристики производительности.
Что такое пятиуровневый паттерн модели?
Он использует ProjectBase для общих полей, ProjectCreate для запросов создания, ProjectUpdate для частичных обновлений, Project для ответов API и ProjectInDB для внутренних документов с метаданными docType.
Как выбрать ключ секции для Cosmos DB?
Выберите ключ секции, который обеспечивает равномерное распределение данных и соответствует паттернам запросов. Для мультитенантных приложений часто используется workspace_id. Проверка доступа к ключу секции должна соответствовать авторизации пользователя для обеспечения границ данных.
Могу ли я использовать этот навык с другими API Azure Cosmos DB, такими как MongoDB или SQL?
Этот навык фокусируется конкретно на API NoSQL с нативным Cosmos SDK. MongoDB и SQL API требуют разных клиентских библиотек и паттернов запросов, хотя принципы архитектуры сервисного уровня остаются применимыми.

Сведения для разработчиков

Автор

sickn33

Лицензия

MIT

Репозиторий

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-cosmos-db-py

Ссылка

main

Структура файлов

📄 SKILL.md