Практическое руководство. Создание хранилища с учетом регистра (CI)
Область применения:✅ хранилище в Microsoft Fabric
Все хранилища Fabric по умолчанию настраиваются с учетом регистра (CS) Latin1_General_100_BIN2_UTF8 сортировки. Вы также можете создавать склады с учетом регистра (CI) сортировки — Latin1_General_100_CI_AS_KS_WS_SC_UTF8.
В настоящее время единственным методом, доступным для создания хранилища данных без учета регистра, является REST API. В этой статье пошаговые инструкции по созданию хранилища с учетом регистра с учетом параметров сортировки с помощью REST API. В нем также объясняется, как использовать Visual Studio Code с расширением клиента REST для упрощения процесса.
Важно!
После создания хранилища невозможно изменить параметр сортировки. Тщательно рассмотрите свои потребности перед началом процесса создания.
- Рабочая область Fabric с активной емкостью или пробной емкостью.
- Скачайте и установите Visual Studio Code , чтобы скачать и установить приложение.
- Установите клиент REST — Visual Studio Marketplace.
Чтобы создать хранилище с помощью REST API, используйте конечную точку API: POST https://api.fabric.microsoft.com/v1/workspaces/<workspace-id>/items
Ниже приведен пример текста запроса JSON для создания хранилища:
{
"type": "Warehouse",
"displayName": "CaseInsensitiveAPIDemo",
"description": "New warehouse with case-insensitive collation",
"creationPayload": {
"defaultCollation": "Latin1_General_100_CI_AS_KS_WS_SC_UTF8"
}
}
Вы можете легко создать новое хранилище с нечувствительной сортировкой регистра с помощью Visual Studio Code (VS Code) и расширения КЛИЕНТА REST. Выполните следующие действия:
Создайте текстовый файл в VS Code с расширением
.http
.Введите сведения о запросе в тексте файла. Обратите внимание, что между заголовком и текстом должно быть пустое пространство, размещенное после строки "Авторизация".
POST https://api.fabric.microsoft.com/v1/workspaces/<workspaceID>/items HTTP/1.1 Content-Type: application/json Authorization: Bearer <bearer token> { "type": "Warehouse", "displayName": "<Warehouse name here>", "description": "<Warehouse description here>", "creationPayload": { "defaultCollation": "Latin1_General_100_CI_AS_KS_WS_SC_UTF8" } }
Замените значения-заполнители:
<workspaceID>
: найдите GUID рабочей области в URL-адресе/groups/
после раздела или выполнив вSELECT @@SERVERNAME
существующем хранилище.<bearer token>
. Получите это, выполнив следующие действия.- Откройте рабочую область Microsoft Fabric в браузере (Microsoft Edge или Google Chrome).
- Нажмите клавишу F12 , чтобы открыть средства разработчика.
- Перейдите на вкладку "Консоль ". При необходимости выберите "Развернуть быстрое представление ", чтобы открыть запрос
>
консоли. - Введите команду
copy(powerBIAccessToken)
и нажмите клавишу ВВОД. В то время как консоль отвечает неопределенной, маркер носителя будет скопирован в буфер обмена. - Вставьте его вместо
<bearer token>
.
Примечание
В некоторых сценариях
copy(powerBIAccessToken)
может завершиться ошибкойuncaught TypeError: copy is not a function
, если на странице есть идентификатор элемента с именем copy. В таких случаях вручную удалите идентификатор элемента с помощью следующей команды перед использованием функции copy:document.querySelector('#copy').remove()
.<Warehouse name here>
: введите требуемое имя хранилища.<Warehouse description here>
: введите требуемое описание хранилища.
Выберите ссылку "Отправить запрос", отображаемую по команде POST в редакторе VS Code.
Вы должны получить ответ с кодом состояния 202 Accepted, а также дополнительные сведения о запросе POST.
Перейдите на только что созданное хранилище на портале Fabric.
Выполните следующую инструкцию T-SQL в редакторе запросов, чтобы убедиться, что параметры сортировки для хранилища соответствуют указанному в приведенном выше формате JSON:
SELECT name, collation_name FROM sys.databases;