Прочитать на английском

Поделиться через


Практическое руководство. Создание хранилища с учетом регистра (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 для упрощения процесса.

Важно!

После создания хранилища невозможно изменить параметр сортировки. Тщательно рассмотрите свои потребности перед началом процесса создания.

Необходимые компоненты

Конечная точка API

Чтобы создать хранилище с помощью 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" 
  } 
}

Вызов REST API с помощью Visual Studio Code

Вы можете легко создать новое хранилище с нечувствительной сортировкой регистра с помощью Visual Studio Code (VS Code) и расширения КЛИЕНТА REST. Выполните следующие действия:

  1. Создайте текстовый файл в VS Code с расширением .http .

  2. Введите сведения о запросе в тексте файла. Обратите внимание, что между заголовком и текстом должно быть пустое пространство, размещенное после строки "Авторизация".

      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" 
       } 
     }
    
  3. Замените значения-заполнители:

    • <workspaceID>: найдите GUID рабочей области в URL-адресе /groups/ после раздела или выполнив в SELECT @@SERVERNAME существующем хранилище.

    • <bearer token>. Получите это, выполнив следующие действия.

      1. Откройте рабочую область Microsoft Fabric в браузере (Microsoft Edge или Google Chrome).
      2. Нажмите клавишу F12 , чтобы открыть средства разработчика.
      3. Перейдите на вкладку "Консоль ". При необходимости выберите "Развернуть быстрое представление ", чтобы открыть запрос >консоли.
      4. Введите команду copy(powerBIAccessToken) и нажмите клавишу ВВОД. В то время как консоль отвечает неопределенной, маркер носителя будет скопирован в буфер обмена.
      5. Вставьте его вместо <bearer token>.

      Примечание

      В некоторых сценариях copy(powerBIAccessToken) может завершиться ошибкой uncaught TypeError: copy is not a function, если на странице есть идентификатор элемента с именем copy. В таких случаях вручную удалите идентификатор элемента с помощью следующей команды перед использованием функции copy: document.querySelector('#copy').remove().

    • <Warehouse name here>: введите требуемое имя хранилища.

    • <Warehouse description here>: введите требуемое описание хранилища.

  4. Выберите ссылку "Отправить запрос", отображаемую по команде POST в редакторе VS Code.

  5. Вы должны получить ответ с кодом состояния 202 Accepted, а также дополнительные сведения о запросе POST.

  6. Перейдите на только что созданное хранилище на портале Fabric.

  7. Выполните следующую инструкцию T-SQL в редакторе запросов, чтобы убедиться, что параметры сортировки для хранилища соответствуют указанному в приведенном выше формате JSON:

    SELECT name, collation_name FROM sys.databases;