Примеры Python для Azure Cosmos DB

ПРИМЕНИМО К: API SQL

Примеры решений, которые выполняют операции CRUD и другие распространенные операции с ресурсами Azure Cosmos DB, содержатся в репозитории GitHub azure-documentdb-python. Эта статья содержит:

  • Ссылки на задачи в каждом из примеров файлов проектов Python.
  • Ссылки на соответствующие справочные материалы по API.

Предварительные требования

Примеры баз данных

В примере database_management.py (Python) показано, как выполнять следующие задачи. Чтобы узнать больше о базах данных Azure Cosmos перед выполнением приведенных ниже примеров, ознакомьтесь с тематической статьей Работа с базами данных, контейнерами и элементами.

Задача Справочник по API
Создание базы данных CosmosClient.create_database
Чтение базы данных по идентификатору CosmosClient.get_database_client
Обращение к базам данных CosmosClient.query_databases
Получение списка баз данных для учетной записи CosmosClient.list_databases
Удаление базы данных CosmosClient.delete_database

Примеры контейнеров

В примере container_management.py (Python) показано, как выполнять следующие задачи. Чтобы узнать больше о коллекциях Azure Cosmos перед выполнением приведенных ниже примеров, ознакомьтесь с тематической статьей Работа с базами данных, контейнерами и элементами.

Задача Справочник по API
Обращение к контейнеру database.query_containers
Создание контейнера database.create_container
Перечисление всех контейнеров в базе данных database.list_containers
Получение контейнера по идентификатору database.get_container_client
Управление подготовленной пропускной способностью контейнера container.read_offer, container.replace_throughput
Удаление контейнера database.delete_container

Примеры элементов

В примере item_management.py (Python) показано, как выполнять следующие задачи. Чтобы узнать больше о документах Azure Cosmos перед выполнением приведенных ниже примеров, ознакомьтесь с тематической статьей Работа с базами данных, контейнерами и элементами.

Задача Справочник по API
Создание элементов в контейнере container.create_item
Считывание элемента по идентификатору container.read_item
Считывание всех элементов в контейнере container.read_all_items
Обращение к элементу по идентификатору container.query_items
Замена элемента container.replace_items
Операция UPSERT элемента container.upsert_item
Удаление элемента container.delete_item
Получение канала изменений элементов в контейнере container.query_items_change_feed

Примеры индексирования

В примере index_management.py (Python) показано, как выполнять следующие задачи. Чтобы узнать больше об индексировании в Azure Cosmos DB перед выполнением приведенных ниже примеров, ознакомьтесь с тематическими статьями, посвященными политикам, типам и путям индексирования.

Задача Справочник по API
Исключение определенного элемента из индексации documents.IndexingDirective.Exclude
Использование ручного индексирования с определенными проиндексированными элементами documents.IndexingDirective.Include
Исключение путей из индексирования Определение путей для исключения в свойстве IndexingPolicy.
Использование диапазонных индексов в строках Определение политики индексации с индексами диапазона для строкового типа данных. 'kind': documents.IndexKind.Range, 'dataType': documents.DataType.String
Преобразование индекса database.replace_container (use the updated indexing policy)
Использование проверки, если в пути существует только хэш-индекс Определение enable_scan_in_query=True и enable_cross_partition_query=True при обращении к элементам