@azure/cosmos (TypeScript/JavaScript)
Разработка приложений Cosmos DB на TypeScript
Разработчикам необходимо эффективно выполнять операции CRUD над документами Azure Cosmos DB. Этот навык предоставляет шаблоны TypeScript для запросов, массовых операций и правильной аутентификации.
Скачать ZIP навыка
Загрузить в Claude
Перейдите в Settings → Capabilities → Skills → Upload skill
Включите и начните использовать
Протестировать
Использование «@azure/cosmos (TypeScript/JavaScript)». Создайте документ продукта с name 'Laptop', price 999.99, category 'electronics'
Ожидаемый результат:
Документ успешно создан с id 'prod-8a7b2c' в контейнере 'products'. Стоимость запроса: 5.21 RU.
Использование «@azure/cosmos (TypeScript/JavaScript)». Запросите продукты, где price < 1000 и category = 'electronics'
Ожидаемый результат:
Получено 15 продуктов, соответствующих критериям. Общая стоимость запроса: 3.47 RU. Результаты включают: Laptop, Tablet, Wireless Mouse, USB Hub...
Аудит безопасности
БезопасноPrompt-only instructional skill containing documentation for Azure Cosmos DB SDK usage. Static analysis scanned 0 files with 0 findings and risk score 0/100. No executable code, network access, or security concerns detected. The skill teaches proper security practices including AAD authentication and parameterized queries.
Оценка качества
Что вы можете построить
Backend-разрабатчик создающий SaaS-приложение
Реализуйте многоарендный уровень данных, используя иерархические ключи секционирования для изоляции данных клиентов при сохранении производительности запросов.
Инженер по обработке данных обрабатывающий транзакции с высоким объёмом
Используйте массовые операции для эффективной вставки, обновления и удаления тысяч документов в секунду с правильной обработкой ошибок.
Full-stack-разработчик создающий приложения реального времени
Создавайте процессоры канала изменений и реализуйте оптимистичный контроль параллелизма для обработки одновременных обновлений от нескольких клиентов.
Попробуйте эти промпты
Создайте функцию TypeScript, которая вставляет новый документ продукта в Azure Cosmos DB. Продукт должен иметь поля id, name, price и category. Используйте DefaultAzureCredential для аутентификации и включите правильную обработку ошибок для дубликатов документов.
Напишите метод службы TypeScript, который выполняет запросы к Cosmos DB для продуктов в ценовом диапазоне. Используйте SqlQuerySpec с именованными параметрами для предотвращения инъекционных атак. Включите поддержку пагинации с токенами продолжения.
Реализуйте функцию массового импорта, которая обрабатывает массив из 1000+ документов, используя executeBulkOperations. Обрабатывайте частичные сбои, логируя неудачные операции с их кодами состояния при продолжении успешных.
Создайте функцию обновления, которая использует ETags для предотвращения потерянных обновлений, когда несколько пользователей изменяют один и тот же документ. Верните конкретную ошибку, когда предварительное условие ETag не выполняется, чтобы клиент мог обновить и повторить попытку.
Лучшие практики
- Используйте DefaultAzureCredential для аутентификации вместо ключей аккаунта в производственных средах
- Всегда используйте параметризованные запросы с SqlQuerySpec для предотвращения инъекций и улучшения кэширования плана запросов
- Указывайте значения ключей секционирования во всех точечных операциях, чтобы избежать накладных расходов кросс-партиционных запросов
Избегать
- Использование ключей аккаунта напрямую в коде вместо переменных среды или управляемого идентификатора
- Выполнение запросов SELECT * без предложений WHERE на больших контейнерах
- Игнорирование ошибок ограничения скорости 429 вместо реализации логики повторных попыток с экспоненциальной задержкой