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

Практическое руководство. Создание хранилища без учета регистра (CI)

Область применения:✅ хранилище в Microsoft Fabric

Хранилища Fabric по умолчанию настроены как чувствительные к регистру 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 Client. Выполните следующие действия:

  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).
      2. Нажмите клавишу F12 , чтобы открыть средства разработчика.
      3. Перейдите на вкладку "Консоль ". При необходимости выберите "Развернуть быстрое представление ", чтобы открыть запрос >консоли.
      4. Введите команду powerBIAccessToken и нажмите клавишу Enter. Щелкните правой кнопкой мыши большую уникальную строку, возвращенную в консоли, и выберите " Копировать содержимое строки".
      5. Вставьте его вместо <bearer token>.
    • <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;

Связанный контент