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


Параметры сортировки хранилища данных

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

Хранилище данных Fabric поддерживает нечувствительные параметры сортировки регистра и регистра. Поддерживаемые параметры сортировки хранилища:

  • Latin1_General_100_BIN2_UTF8 (по умолчанию) (учитывает регистр)
  • Latin1_General_100_CI_AS_KS_WS_SC_UTF8 (без учета регистра)

Новые хранилища и все конечные точки аналитики SQL настраиваются на основе параметра сортировки хранилища данных рабочей области по умолчанию, который по умолчанию является параметры сортировки с учетом Latin1_General_100_BIN2_UTF8регистра.

Изменение параметров сортировки на уровне рабочей области не влияет на существующие хранилища или конечные точки аналитики SQL. Запросы между хранилищами могут столкнуться с ошибками или непредвиденными результатами запросов между элементами с различными параметрами сортировки.

Чтобы создать хранилище с нечувствительной сортировкой регистра, выполните следующие действия.

Внимание

После создания хранилища или конечной точки аналитики SQL невозможно изменить параметры сортировки.

Изменение сортировки рабочей области по умолчанию для хранилища данных Fabric

В этом разделе объясняется, как настроить параметры сортировки по умолчанию для хранилищ на уровне рабочей области, параметр влияет на все элементы конечной точки хранилища и аналитики SQL.

Permissions

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

Изменение сортировки рабочей области по умолчанию для хранилища данных Fabric на портале Fabric

  1. Перейдите в рабочую область Microsoft Fabric.
  2. Откройте параметры рабочей области.
  3. В окне параметров рабочей области перейдите на вкладку "Хранилище данных ".
  4. Выберите страницу параметров сортировки .
  5. В разделе "Конфиденциальность регистра" выберите "Регистр" (Latin1_General_100_BIN2_UTF8) (по умолчанию) или "Без учета регистра" (Latin1_General_100_CI_AS_KS_WS_SC_UTF8). Все новые элементы хранилища и конечных точек аналитики SQL, созданные в этой рабочей области, будут созданы с выбранным параметром сортировки рабочей области.
  6. После создания хранилища используйте следующую инструкцию T-SQL в редакторе запросов Fabric , чтобы подтвердить параметры сортировки хранилища:
    SELECT name, collation_name FROM sys.databases;
    

Замечание

Новый элемент конечной точки аналитики SQL для новой зеркальной базы данных SQL Server, зеркальной базы данных управляемого экземпляра SQL, зеркальной базы данных SQL Azure или базы данных SQL в Fabric использует параметры сортировки рабочей области Fabric, а не параметры сортировки родительского элемента.

Создание хранилища с параметрами сортировки, отличной от по умолчанию, с помощью REST API

В этом разделе объясняется, как использовать Visual Studio Code для создания хранилища с нестандартной сортировкой с помощью расширения КЛИЕНТА REST.

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

Чтобы создать хранилище с помощью REST API, используйте конечную точку API: POST https://api.fabric.microsoft.com/v1/workspaces/<workspace-id>/items

Ниже приведен пример текста запроса JSON для создания хранилища, включая параметры сортировки хранилища:defaultCollation

{ 
  "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 и расширения КЛИЕНТА REST. Выполните следующие действия:

  1. Если это еще не так, скачайте и установите Visual Studio Code , чтобы скачать и установить приложение.

  2. Установите клиент REST — Visual Studio Marketplace.

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

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

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

    • <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>: введите требуемое описание хранилища.
  6. Выберите ссылку "Отправить запрос", отображаемую по команде POST в редакторе VS Code.

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

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

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

    SELECT name, collation_name FROM sys.databases;