Навыки Azure Cosmos DB SDK for Python
📦

Azure Cosmos DB SDK for Python

Безопасно 🌐 Доступ к сети🔑 Переменные окружения

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

Работа с глобально распределёнными базами данных требует понимания ключей секции и эффективных запросов. Этот навык предоставляет готовые к использованию в продакшене шаблоны для операций Azure Cosmos DB с использованием официального Python SDK.

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

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

2

Загрузить в Claude

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

3

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

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

Использование «Azure Cosmos DB SDK for Python». Query items where price is less than 500 in the electronics partition

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

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

Использование «Azure Cosmos DB SDK for Python». Upsert a new product item with id, category, name, and price fields

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

Создаёт элемент, если он не существует, или заменяет его, если он существует, возвращая созданный или обновлённый документ с системными метаданными, такими как _ts и _rid.

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

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

This is a prompt-only skill containing documentation and code examples for Azure Cosmos DB SDK. Static analysis found 0 security issues with a risk score of 0/100. The skill provides legitimate database operation patterns using official Azure SDK libraries. Network and environment access patterns shown are standard Azure authentication flows requiring user-provided credentials.

0
Просканировано файлов
0
Проанализировано строк
2
находки
1
Всего аудитов

Факторы риска

🌐 Доступ к сети
Конкретные расположения не записаны
🔑 Переменные окружения
Конкретные расположения не записаны
Проверено: claude

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

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

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

Каталог товаров для электронной коммерции

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

Хранилище телеметрии IoT

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

Управление пользовательскими сессиями

Реализация хранилища сессий с низкой задержкой и автоматическим переключением между регионами Azure с использованием уровней согласованности Cosmos DB и политик TTL.

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

Базовые операции CRUD
Создайте скрипт Python, который подключается к Azure Cosmos DB и выполняет операции создания, чтения, обновления и удаления в контейнере, хранящем профили пользователей с ключом секции /user_id.
Параметризованный запрос с фильтрацией
Напишите функцию запроса, которая извлекает товары с ценой ниже максимальной в определённой категории секции с использованием параметризованного SQL для предотвращения инъекций и улучшения кэширования.
Асинхронная пакетная вставка с высокой пропускной способностью
Реализуйте асинхронную функцию Python, которая пакетами вставляет 1000 элементов в Cosmos DB с использованием асинхронного клиента с правильной обработкой ошибок и логикой повторных попыток для ограничения скорости.
Создание контейнера со стратегией секционирования
Сгенерируйте скрипт настройки, который создаёт контейнер Cosmos DB с иерархическими ключами секции, подготовленной пропускной способностью 5000 ЕЗ/с и соответствующими политиками индексации для мультиарендной системы журналирования событий.

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

  • Всегда указывайте ключ секции для точечных чтений и запросов, чтобы минимизировать задержку и стоимость
  • Используйте параметризованные запросы вместо конкатенации строк для предотвращения атак инъекций
  • Проектируйте ключи секции для равномерного распределения данных, чтобы избежать горячих секций

Избегать

  • Выполнение запросов между секциями без флага enable_cross_partition_query
  • Использование read_all_items без фильтрации по ключу секции в рабочих нагрузках продакшена
  • Создание контейнеров без предварительного планирования стратегии ключа секции

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

Какова минимальная пропускная способность для контейнера Cosmos DB?
Минимальная подготовленная пропускная способность составляет 400 ЕЗ/с для одной секции. Режим без сервера также доступен для непредсказуемых рабочих нагрузок.
Как обрабатывать ошибки ограничения скорости 429?
Перехватывайте CosmosHttpResponseError с кодом состояния 429 и повторяйте попытку после длительности, указанной в заголовке x-ms-retry-after-ms.
Можно ли изменить ключ секции после создания контейнера?
Нет, ключи секции являются неизменяемыми. Вы должны перенести данные в новый контейнер, если вам нужно изменить стратегию секционирования.
Какие методы аутентификации поддерживает SDK?
SDK поддерживает аутентификацию по строке подключения и аутентификацию на основе Azure Identity с использованием DefaultAzureCredential для управляемых удостоверений.
Как включить асинхронные операции в SDK?
Импортируйте CosmosClient из azure.cosmos.aio и используйте асинхронные контекстные менеджеры с await для всех операций с базой данных.
Какие уровни согласованности доступны в Cosmos DB?
Cosmos DB предлагает пять уровней: строгая, ограниченная согласованность, сессия, согласованный префикс и конечная, с компромиссом между задержкой и согласованностью.

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

Автор

sickn33

Лицензия

MIT

Ссылка

main

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

📄 SKILL.md