Часто задаваемые вопросы об API для таблицы в Azure Cosmos DB

Существуют некоторые различия в поведении, которые следует учитывать пользователям, поступающим из хранилища таблиц Azure, которые хотят создавать таблицы с помощью Azure Cosmos DB для таблиц:

• Azure Cosmos DB для таблицы использует модель зарезервированной емкости для обеспечения гарантированной производительности, но это означает, что она оплачивается сразу после создания таблицы, даже если емкость не используется. При использовании хранилища таблиц Azure вы платите только за используемую емкость. Это помогает объяснить, почему API для таблицы может предлагать соглашение об уровне обслуживания для чтения 10 мс и 15 мс на запись на 99-м процентиле, в то время как хранилище таблиц Azure предлагает 10-секундное соглашение об уровне обслуживания. Но, как следствие, использование API для таблиц таблиц, даже пустых таблиц без каких-либо запросов, стоить денег, чтобы обеспечить доступность емкости для обработки любых запросов к ним в рамках SLA, предлагаемого Azure Cosmos DB.

• Результаты запроса, возвращаемые API для таблицы, не сортируются в порядке ключа секции или ключа строки, как в хранилище таблиц Azure.

• Ключи строк могут содержать не более 255 байт.

• Пакеты могут содержать не более 2 МБ.

• В настоящий момент CORS не поддерживается.

• В именах таблиц в хранилище таблиц Azure регистр не учитывается, но они находятся в Azure Cosmos DB для таблицы.

• Некоторые внутренние форматы кодирования информации Azure Cosmos DB, например двоичные поля, в настоящее время не так эффективны, как хотелось бы. Поэтому на размер данных могут накладываться неожиданные ограничения. Например, сейчас невозможно использовать полную 1-мегабайтную сущность таблицы для хранения двоичных данных, так как кодировка увеличивает размер данных.

• Имена IDсвойств сущностей , id, rid, etagи ResourceId зарезервированы для использования Cosmos DB и в настоящее время не поддерживаются.

• Значение TakeCount для TableQuery не ограничено 1000.

• С точки зрения REST API следующие конечные точки и параметры запросов поддерживаются хранилищем таблиц Azure, но не поддерживаются Azure Cosmos DB для таблиц:

  Методы REST	Конечная точка или параметр запроса REST	URL-адреса документов	Объяснение	Поддерживается в Хранилище таблиц	Поддерживается в API для таблиц
  GET, PUT	/?restype=service@comp=properties	Set Table Service Properties (Настройка свойств службы таблиц) и Get Table Service Properties (Получение свойств службы таблиц)	Эта конечная точка используется для настройки правил CORS, конфигурации аналитики хранилища и настроек ведения журналов. В настоящее время CORS не поддерживается, а аналитика и ведение журналов обрабатываются в базе данных Azure Cosmos и в таблицах хранения Azure по-разному.	Да	Нет
  OPTIONS	/<table-resource-name>	Preflight Table Request (Предварительные запросы таблиц)	Этот метод является частью CORS и сейчас не поддерживается в Azure Cosmos DB.	Да	Нет
  GET	/?restype=service@comp=stats	Get Table Service Stats (Получение статистики службы таблиц)	Предоставляет сведения о том, как быстро данные копируются между первичными и вторичными базами данных. Это не требуется в Azure Cosmos DB, так как репликация является частью операций записи.	Да	Нет
  GET, PUT	/mytable?comp=acl	Get Table ACL (Получение ACL таблиц) и Set Table ACL (Настройка ACL таблиц)	Этот метод получает и устанавливает хранимые политики доступа, используемые для управления подписями коллективного доступа (SAS).	Да	Нет

• Azure Cosmos DB для таблицы поддерживает только формат JSON, но не ATOM.

• Сейчас Azure Cosmos DB не поддерживает некоторые классы и методы, предусмотренные для пакета SDK для .NET.

  Class	Неподдерживаемый метод
  CloudTableClient	*ServiceProperties*
  	*ServiceStats*
  CloudTable	SetPermissions*
  	GetPermissions*
  TableServiceContext	* (не рекомендуется использовать этот класс)
  TableServiceEntity	" "
  TableServiceExtensions	" "
  TableServiceQuery	" "

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

Используйте следующую строку подключения:

DefaultEndpointsProtocol=https;AccountName=<AccountNamefromCosmosDB;AccountKey=<FromKeysPaneofCosmosDB>;TableEndpoint=https://<AccountName>.table.cosmosdb.azure.com

Вы можете получить строку подключения на странице строки подключения на портале Azure.

Некоторые параметры обрабатываются методом CreateCloudTableClient, а другие — с помощью app.config в разделе appSettings в клиентском приложении. Сведения о параметрах конфигурации см. в описании возможностей Azure Cosmos DB.

Нет. Для существующих или новых клиентов, использующих имеющиеся пакеты SDK для хранилища таблиц Azure, никаких изменений не предусмотрено.

Чтобы просмотреть данные, используйте портал Azure. Вы также можете использовать API для кода таблицы или средства, упомянутые в следующем ответе.

Вы можете использовать обозреватель хранилищ Azure.

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

Да, оптимистическая блокировка операций обеспечивается за счет использования механизма ETag.

Да, API для таблицы поддерживает запросы OData и запросы LINQ.

Да, подключение возможно, если вы создадите два отдельных экземпляра CloudTableClient, каждый из которых указывает на свой собственный URI в строке подключения.

Поддерживается AzCopy.

Azure Cosmos DB предоставляет неограниченный объем хранилища за счет горизонтального масштабирования. Увеличение объема хранилища осуществляется службой по мере необходимости.

Вы можете использовать панель API для метрик таблиц для мониторинга запросов и использования хранилища.

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

На данный момент нет.

Да, поддерживается такой же API.

Нет, вы можете создавать и использовать существующие ресурсы хранилища таблиц Azure, не прерывая работу. Однако если вы не используете API для таблицы, вы не сможете воспользоваться автоматическим индексом, дополнительным параметром согласованности или глобальным распределением.

Вы можете использовать параметры глобальной репликации портала Azure Cosmos DB для добавления регионов, поддерживаемых приложением. Чтобы разработать глобально распределенное приложение, вы также должны добавить приложение, присвоив ключу PreferredLocation значение локального региона. Так вы сможете обеспечить низкую задержку операций чтения.

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

Чтобы облегчить чтение из локального расположения, используйте ключ PreferredLocation в файле app.config. Для существующих приложений API для таблицы выдает ошибку, если задан параметр LocationMode. Удалите этот код, так как API для таблицы извлекает эти сведения из файла app.config.

В Azure Cosmos DB реализованы продуманные компромиссные сочетания показателей согласованности, доступности и задержки. Azure Cosmos DB предлагает пять уровней согласованности API для разработчиков таблиц, поэтому вы можете выбрать правильную модель согласованности на уровне таблицы и выполнять отдельные запросы при запросе данных. Подключаемый клиент может выбирать уровень согласованности. Вы можете изменить уровень с помощью аргумента consistencyLevel для CreateCloudTableClient.

API для таблиц предоставляет операции чтения с низкой задержкой, а по умолчанию — "Чтение собственных записей" с согласованностью с ограниченным устареванием. Дополнительные сведения см. в статье Настраиваемые уровни согласованности данных в DocumentDB.

По умолчанию хранилище таблиц Azure обеспечивает строгую согласованность в пределах региона и итоговую согласованность в дополнительных расположениях.

Да, см. дополнительные сведения о распределенном характере Azure Cosmos DB в описании уровней согласованности. Так как уровни согласованности подкреплены гарантийными обязательствами, вы можете больше не беспокоиться об этом.

Azure Cosmos DB надежно фиксирует данные в локальном регионе, отправляя их в другие регионы за миллисекунды. Такая репликация зависит только от времени кругового пути центра обработки данных. См. дополнительные сведения о возможностях глобально распределенной службы базы данных Azure Cosmos DB.

В Azure Cosmos DB можно указать уровень согласованности на уровне контейнера (в таблице). Пакет SDK для .NET также позволяет указать этот уровень, изменив значение ключа TableConsistencyLevel в файле app.config. Вы можете выбрать строгую согласованность, согласованность с ограниченным устареванием, согласованность на уровне сеанса, согласованность префиксов и итоговую согласованность. См. дополнительные сведения о настраиваемых уровнях согласованности данных в Azure Cosmos DB. Основная идея состоит в том, что уровень согласованности для запросов не может быть выше уровня согласованности для таблицы. Например, вы не можете выбрать для таблицы итоговую согласованность, а для запросов — строгую согласованность.

API для таблицы использует глобально распределенную платформу Azure Cosmos DB. Чтобы обеспечить нормальную работу приложения при простое центра обработки данных, вам нужно использовать несколько регионов для учетной записи на портале Azure Cosmos DB. См. дополнительные сведения о разработке с использованием учетных записей Azure Cosmos DB с поддержкой нескольких регионов. Вы можете задать приоритет регионов. Дополнительные сведения см. в статье Автоматическая отработка отказа между регионами для обеспечения непрерывности бизнес-процессов в DocumentDB.

Вы можете не только добавить любое нужное число регионов для учетной записи, но и управлять тем, в какой регион будет выполняться отработка отказа, настроив приоритет для этой процедуры. Чтобы использовать базу данных, вам также нужно предоставить приложение. В это время ваши клиенты смогут работать без простоя. В отличие от других, последняя версия клиентского пакета SDK для .NET автоматически обнаруживает регион. То есть он может определять регион, который стал недоступен, и автоматически выполнять отработку отказа в другой регион.

Да, API для таблиц использует платформу Azure Cosmos DB для резервного копирования. Резервные копии создаются автоматически. См. дополнительные сведения об оперативном резервном копировании и восстановлении с помощью Azure Cosmos DB.

Да, по умолчанию индексируются все атрибуты сущности. Дополнительные сведения см. в статье Политика индексирования в Azure Cosmos DB.

Да, Azure Cosmos DB для таблицы обеспечивает автоматическое индексирование всех атрибутов без определения схемы. Таким образом, разработчик может сосредоточиться на приложении, не беспокоясь о создании индексов и управлении ими. Дополнительные сведения см. в статье Политика индексирования в Azure Cosmos DB.

Да, вы можете изменить политику индексирования, предоставив определение индекса. Вам нужно правильно закодировать эти параметры, а также экранировать их.

Политику индексирования можно установить ​​только на портале в обозревателе данных. Перейдите к таблице, которую нужно изменить, выберите Масштаб и параметры -> "Политика индексации", внесите необходимые изменения и нажмите Сохранить.

a. Индексация только по ключу секции и ключу строки

  {
    "indexingMode": "consistent",
    "automatic": true,
    "includedPaths": [
      {
        "path": "/\"$pk\"/?"
      },
      {
        "path": "/\"$id\"/?"
      }
    ],
    "excludedPaths": [
      {
        "path": "/*"
      },
      {
        "path": "/\"_etag\"/?"
      }
    ]
  } 

b. Индексация по настраиваемому столбцу

  {
    "indexingMode": "consistent",
    "automatic": true,
    "includedPaths": [
      {
        "path": "/\"mycolumn\"/*"
      } 
    ],
    "excludedPaths": [
      {
        "path": "/*"
      },
      {
       "path": "/\"_etag\"/?"
      }
    ]
  }  

API для таблиц предоставляет те же функции запросов, что и хранилище таблиц Azure. Кроме того, эта база данных поддерживает сортировку, выполнение статистических вычислений, геопространственные запросы, иерархию и множество встроенных функций. Дополнительные сведения см. в статье Запросы SQL для Azure Cosmos DB.

Значение TableThroughput следует изменять в следующих случаях:

• При извлечении, преобразовании и загрузке данных или при передаче большого объема данных за короткий промежуток времени.
• Чтобы получить более высокую пропускную способность для контейнера или набора контейнеров в серверной части. Например, вы видите, что используемая пропускная способность превышает подготовленную и выполняется регулирование. Дополнительные сведения см. в статье Настройка пропускной способности для коллекций Azure Cosmos DB.

Да, для этого вы можете использовать панель масштабирования портала Azure Cosmos DB. См. дополнительные сведения о настройке пропускной способности.

Да, если не переопределить пропускную способность таблицы с помощью файла app.config и не использовать предварительно созданный контейнер в Azure Cosmos DB, служба создаст таблицу с предопределенной пропускной способностью (400).

Нет. Цены для существующих клиентов хранилища таблиц Azure не изменились.

Это зависит от заданного значения TableThroughput.

Если скорость запроса превышает емкость подготовленной пропускной способности для базового контейнера или набора контейнеров, вы получите сообщение об ошибке, а пакет SDK повторит вызов на основе политики повтора.

Azure Cosmos DB определяет для вашего контейнера пропускную способность по умолчанию, если вы не укажете другое значение в файле app.config или на портале.

Azure Cosmos DB предоставляет гарантии производительности и задержки с верхними границами для операций. Это возможно, если обработчик может применить управление операциями клиента. Настраивая значение TableThroughput, вы гарантированно получаете требуемые показатели пропускной способности и задержки, так как платформа резервирует эту емкость и обеспечивает бесперебойное выполнение операций.

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

Azure Cosmos DB — это глобально распределенная система на основе соглашений об уровне обслуживания, которая гарантирует высокую доступность, низкую задержку и высокую пропускную способность. В отличие от других систем, в Azure Cosmos DB гарантируется зарезервированная пропускная способность. Azure Cosmos DB предоставляет такие запрашиваемые клиентами дополнительные возможности, как вторичные индексы и глобальное распространение.

Azure Cosmos DB — это система на основе соглашений об уровне обслуживания, которая предоставляет неограниченные возможности масштабирования, а также гарантирует согласованность, низкую задержку, высокую пропускную способность и доступность. Объем данных и индекс должны быть управляемыми и масштабируемыми, чтобы получить гарантированную производительность уровня "Премиум". Ограничение в 20 ГБ для числа сущностей и элементов на ключ секции требуется для повышения скорости поиска и производительности запросов. Кроме того, для обеспечения достаточной масштабируемости приложения для службы хранилища Azure мы рекомендуем не создавать секцию с высокой нагрузкой, чтобы хранить в ней все сведения и выполнять запрос этих данных.

Да. Так как поверхность API для таблицы аналогична поверхности пакета SDK хранилища таблиц Azure, ключ секции обеспечивает эффективный способ распространения данных. Ключ строки является уникальным в пределах такой секции. Его присутствие обязательно, а значение может быть нулевым, как в пакете SDK уровня "Стандартный". Размер значения RowKey составляет 255 байт, а значения PartitionKey — 1 КБ.

Хранилище таблиц Azure и Azure Cosmos DB для таблиц используют одни и те же пакеты SDK, поэтому большинство ошибок будут одинаковыми.

Azure Cosmos DB — это система на основе соглашений об уровне обслуживания, которая гарантирует согласованность, низкую задержку, высокую пропускную способность и доступность. Так как это подготовленная система, она способна резервировать ресурсы, чтобы гарантировать выполнение этих требований. Эта система определяет создание таблиц в быстром режиме и выполняет регулирование. Мы рекомендуем создавать не более пяти таблиц в минуту. Помните, что API для таблицы является подготовленной системой. Оплата начисляется с момента подготовки.

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

• Страница вопросов на сайте Microsoft Q&A.
• Stack Overflow. Stack Overflow лучше всего подходит, чтобы задать вопросы о программировании. Ваш вопрос должен быть по теме и максимально точным и подробным, чтобы на него можно было ответить по существу.

Дальнейшие действия

• Создание приложения API для таблиц с помощью пакета SDK для .NET и Azure Cosmos DB
• Создание приложения Java для управления Azure Cosmos DB для табличных данных