Настройка параметров массового импорта

Служба FHIR поддерживает $import операцию, которая позволяет импортировать данные в службу FHIR из учетной записи хранения. Импорт разделяет входные файлы в несколько потоков данных для оптимальной производительности и не гарантирует порядок обработки ресурсов. На сегодняшний день поддерживаются два режима $import:

• Начальный режим предназначен для загрузки ресурсов FHIR на пустой сервер FHIR. Начальный режим поддерживает только операции CREATE и, если этот параметр включен, блокирует операции записи API на сервер FHIR.

• Добавочный режим оптимизирован для периодической загрузки данных на сервер FHIR и не блокирует операции записи через API. Он также позволяет загружать lastUpdated и versionId из мета ресурса (если он присутствует в json ресурса).

В этом документе мы рассмотрим три шага, которые используются при настройке параметров импорта в службе FHIR:

1. Включите управляемое удостоверение в службе FHIR.
2. Создайте учетную запись хранения Azure или используйте существующую учетную запись хранения, а затем предоставьте службе FHIR разрешения на доступ к ней.
3. Задайте конфигурацию импорта в службе FHIR.

Шаг 1. Включение управляемого удостоверения в службе FHIR

Первым шагом является включение управляемого удостоверения на уровне системы в службе. Он будет использоваться для предоставления службе FHIR доступа к учетной записи хранения. Дополнительные сведения об управляемых удостоверениях в Azure см. в статье Об управляемых удостоверениях для ресурсов Azure.

Выполните действия, чтобы включить управляемое удостоверение в службе FHIR.

1. Перейдите к службе FHIR в портал Azure.
2. Выберите колонку Удостоверение .
3. Выберите для параметра Состояние значение Вкл . , а затем нажмите кнопку Сохранить.
4. Выберите Да , чтобы включить управляемое удостоверение для службы FHIR.

После включения удостоверения системы вы увидите значение GUID, назначенное системой.

Шаг 2. Назначение разрешений службе FHIR на доступ к учетной записи хранения

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

1. Перейдите к контроль доступа (IAM) в учетной записи хранения.
2. Выберите Добавить назначение ролей. Если на этом шаге параметр добавить назначение ролей неактивен, необходимо попросить администратора Azure назначить вам разрешение на выполнение этого шага. Дополнительные сведения о назначении ролей в портал Azure см. в статье Встроенные роли Azure.
3. Добавьте роль Участник данных BLOB-объектов хранилища в службу FHIR.
4. Щелкните Сохранить.

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

Шаг 3. Настройка конфигурации импорта службы FHIR

Для этого шага необходимо получить URL-адрес запроса и текст JSON. Следуйте указаниям ниже

1. Перейдите к портал Azure службы FHIR.
2. Щелкните Обзор.
3. Выберите Представление JSON.
4. Выберите версию API до 2022-06-01 или более поздней версии.

Чтобы указать учетную запись хранения Azure в представлении JSON, необходимо использовать REST API для обновления службы FHIR.

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

Шаг 3а. Настройка конфигурации импорта для режима начального импорта.

Выполните следующие изменения в JSON:

1. Присвойте параметру enabled в importConfiguration значение true.
2. Обновите integrationDataStore, указав имя целевой учетной записи хранения.
3. Задайте для параметра initialImportMode в importConfiguration значение true.
4. Удалите provisioningState.

Завершив этот последний шаг, вы можете выполнить импорт в исходном режиме с помощью $import.

Шаг 3б. Настройка конфигурации импорта для режима добавочного импорта.

Выполните следующие изменения в JSON:

1. Присвойте параметру enabled в importConfiguration значение true.
2. Обновите integrationDataStore, указав имя целевой учетной записи хранения.
3. Задайте для параметра initialImportMode в importConfiguration значение false.
4. Удалите provisioningState.

После завершения этого последнего шага можно приступать к импорту в добавочном режиме с помощью $import.

Обратите внимание, что вы также можете использовать кнопку Развернуть в Azure, чтобы открыть пользовательский шаблон Resource Manager, который обновляет конфигурацию для $import.

Защита операции $import службы FHIR

Для безопасного импорта данных FHIR в службу FHIR из учетной записи ADLS 2-го поколения существует два варианта:

• Вариант 1. Включение службы FHIR в качестве доверенной службы Майкрософт.

• Вариант 2. Предоставление доступа к учетной записи хранения для определенных IP-адресов, связанных со службой FHIR. Этот параметр позволяет использовать две разные конфигурации в зависимости от того, находится ли учетная запись хранения в том же регионе Azure, что и служба FHIR.

Вариант 1. Включение службы FHIR в качестве доверенной службы Майкрософт.

Перейдите к своей учетной записи ADLS 2-го поколения в портал Azure и выберите колонку Сеть. Выберите Включено из выбранных виртуальных сетей и IP-адресов на вкладке Брандмауэры и виртуальные сети .

Выберите Microsoft.HealthcareApis/workspaces в раскрывающемся списке Тип ресурса , а затем выберите свою рабочую область в раскрывающемся списке Имя экземпляра .

В разделе Исключения установите флажок Разрешить службам Azure в списке доверенных служб доступ к этой учетной записи хранения. Не забудьте нажать кнопку Сохранить , чтобы сохранить параметры.

Затем выполните следующую команду PowerShell, чтобы установить Az.Storage модуль PowerShell в локальной среде. Это позволит настроить учетные записи хранения Azure с помощью PowerShell.

Install-Module Az.Storage -Repository PsGallery -AllowClobber -Force 

Теперь используйте приведенную ниже команду PowerShell, чтобы задать выбранный экземпляр службы FHIR в качестве доверенного ресурса для учетной записи хранения. Убедитесь, что все перечисленные параметры определены в среде PowerShell.

Обратите внимание, что в локальной Add-AzStorageAccountNetworkRule среде необходимо выполнить команду от имени администратора. Дополнительные сведения см. в статье Настройка брандмауэров службы хранилища Azure и виртуальных сетей.

$subscription="xxx"
$tenantId = "xxx"
$resourceGroupName = "xxx"
$storageaccountName = "xxx"
$workspacename="xxx"
$fhirname="xxx"
$resourceId = "/subscriptions/$subscription/resourceGroups/$resourceGroupName/providers/Microsoft.HealthcareApis/workspaces/$workspacename/fhirservices/$fhirname"

Add-AzStorageAccountNetworkRule -ResourceGroupName $resourceGroupName -Name $storageaccountName -TenantId $tenantId -ResourceId $resourceId

После выполнения приведенной выше команды в разделе Брандмауэр в разделе Экземпляры ресурсов в раскрывающемся списке Имя экземпляра будет выбрано 2. Это имена экземпляра рабочей области и экземпляра службы FHIR, зарегистрированных в качестве доверенных ресурсов Майкрософт.

Теперь вы готовы безопасно импортировать данные FHIR из учетной записи хранения. Учетная запись хранения находится в выбранных сетях и не является общедоступной. Для безопасного доступа к файлам можно включить частные конечные точки для учетной записи хранения.

Вариант 2.

Предоставление доступа к учетной записи хранения Azure определенным IP-адресам из других регионов Azure

В портал Azure перейдите к учетной записи ADLS 2-го поколения и выберите колонку Сеть.

Выберите Включено из выбранных виртуальных сетей и IP-адресов. В разделе Брандмауэр укажите IP-адрес в поле Диапазон адресов . Добавьте диапазоны IP-адресов, чтобы разрешить доступ из Интернета или локальных сетей. IP-адрес можно найти в таблице ниже для региона Azure, в котором подготовлена служба FHIR.

Разрешение определенным IP-адресам доступа к учетной записи хранения Azure в том же регионе

Процесс настройки IP-адресов в том же регионе выглядит так же, как описано выше, за исключением определенного диапазона IP-адресов Inter-Domain в формате CIDR (т. е. 100.64.0.0/10). Необходимо указать диапазон IP-адресов (100.64.0.0 –100.127.255.255), так как IP-адрес для службы FHIR будет выделяться при каждом выполнении запроса операции.

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

Из этой статьи вы узнали, как служба FHIR поддерживает $import операции и позволяет импортировать данные в службу FHIR из учетной записи хранения. Вы также узнали о трех шагах, используемых при настройке параметров импорта в службе FHIR. Дополнительные сведения о преобразовании данных в FHIR, экспорте параметров для настройки учетной записи хранения и перемещении данных в Azure Synapse см. в статье.

FHIR® является зарегистрированным товарным знаком HL7 и используется с разрешения HL7.