Руководство по принятию и получению данных в Azure Data Share

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

Как принять приглашение Azure Data Share
Создание учетной записи Azure Data Share
Указание назначения для данных
Создайте подписку на публикацию данных для запланированного обновления

Предпосылки

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

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

Подписка Azure. Если у вас нет подписки Azure, создайте бесплатную учетную запись перед началом работы.
Приглашение к Azure Data Share: приглашение из Microsoft Azure с темой "Приглашение Azure Data Share из [email protected]".
Зарегистрируйте поставщика ресурсов Microsoft.DataShare в подписке Azure, где вы создадите ресурс Data Share и подписку Azure, в которой находятся целевые хранилища данных Azure.

Получение данных в учетную запись хранения

Учетная запись хранения Azure: если у вас еще нет учетной записи хранения Azure, можно создать учетную запись хранения Azure.
Разрешение на запись в учетную запись хранения, которая присутствует в Microsoft.Storage/storageAccounts/write. Это разрешение существует в роли участника учетной записи хранения .
Разрешение на добавление назначения ролей в учетную запись хранения, которая присутствует в Microsoft.Authorization/role assignments/write. Это разрешение существует в роли владельца.

Получение данных в целевой объект на основе SQL

Если вы решили получать данные в базу данных SQL Azure, Azure Synapse Analytics ниже приведен список предварительных требований.

Предварительные требования для получения данных в базу данных SQL Azure или Azure Synapse Analytics (ранее — хранилище данных SQL Azure)

База данных Azure SQL или Azure Synapse Analytics (ранее — Azure SQL DW).
Разрешение на запись в базы данных на сервере SQL Server, которое присутствует в Microsoft.Sql/servers/database/write. Это разрешение существует в роли Соавтор.
Администратор Microsoft Entra SQL сервера
Доступ к брандмауэру SQL Server. Это можно сделать, выполнив следующие действия.
1. В SQL Server на портале Azure перейдите к Брандмауэры и виртуальные сети
2. Выберите "Да" , чтобы разрешить службам и ресурсам Azure доступ к этому серверу.
3. Выберите +Добавить IP-адрес клиента. IP-адрес клиента подлежит изменению. Этот процесс может потребоваться повторить при следующем обмене данными SQL с портала Azure. Вы также можете добавить диапазон IP-адресов.
4. Нажмите кнопку "Сохранить".

Требования для получения данных в SQL-пул Azure Synapse Analytics (рабочее пространство)

Выделенный пул SQL Azure Synapse Analytics (рабочее пространство). Получение данных в бессерверный пул SQL в настоящее время не поддерживается.
Разрешение на запись в пул SQL рабочей области Synapse, содержащейся в Microsoft.Synapse/workspaces/sqlPools/write. Это разрешение существует в роли Соавтор.
Разрешение управляемого удостоверения ресурса Data Share на доступ к SQL-пулу рабочего пространства Synapse. Это можно сделать, выполнив следующие действия.
1. На портале Azure перейдите в рабочую область Synapse. Выберите администратора Microsoft Entra в левой области навигации и задайте себя администратором Microsoft Entra.
2. Откройте Synapse Studio, выберите "Управление" в области навигации слева. Выберите элемент управления доступом в разделе "Безопасность". Назначьте себе роль администратора SQL или администратора рабочей области .
3. В Synapse Studio выберите "Разработка " в области навигации слева. Выполните следующий сценарий в пуле SQL, чтобы добавить управляемое удостоверение ресурса Data Share в качестве db_datareader, db_datawriter, db_ddladmin.
```
create user "<share_acc_name>" from external provider; 
exec sp_addrolemember db_datareader, "<share_acc_name>"; 
exec sp_addrolemember db_datawriter, "<share_acc_name>"; 
exec sp_addrolemember db_ddladmin, "<share_acc_name>";
```
  Share_acc_name<> — это имя ресурса Data Share. Если вы еще не создали ресурс Общего доступа к данным, вы можете вернуться к этому условию позже.
Доступ к брандмауэру рабочей области Synapse. Это можно сделать, выполнив следующие действия.
1. На портале Azure перейдите в рабочую область Synapse. Выберите брандмауэры в левой панели навигации.
2. Выберите ON для разрешения служб и ресурсов Azure для доступа к этой рабочей области.
3. Выберите +Добавить IP-адрес клиента. IP-адрес клиента подлежит изменению. Этот процесс может потребоваться повторить при следующем обмене данными SQL с портала Azure. Вы также можете добавить диапазон IP-адресов.
4. Нажмите кнопку "Сохранить".

Получение данных в кластер Azure Data Explorer:

Кластер Azure Data Explorer в том же центре обработки данных Azure, что и кластер обозревателя данных поставщика данных: если у вас еще нет кластера, можно создать кластер Azure Data Explorer. Если вы не знаете центр обработки данных Azure кластера поставщика данных, вы можете создать кластер позже в процессе.
Разрешение на запись в кластер Azure Data Explorer, который присутствует в Microsoft.Kusto/clusters/write. Это разрешение существует в роли контрибьютора.

Войдите на портал Azure.

Открытое приглашение

Вы можете открыть приглашение из электронной почты или непосредственно на портале Azure.

Чтобы открыть приглашение из электронной почты, проверьте ваш почтовый ящик на наличие приглашения от поставщика данных. Приглашение из Microsoft Azure называется приглашением Azure Data Share от [email protected]. Выберите "Просмотреть приглашение" , чтобы просмотреть приглашение в Azure.

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

Если вы являетесь гостевым пользователем клиента, вам будет предложено проверить свой адрес электронной почты для клиента, прежде чем просматривать приглашение к общей папке данных в первый раз. После проверки он действителен в течение 12 месяцев.
Выберите приглашение, которое хотите просмотреть.

Подготовьте среду Azure CLI и просмотрите приглашения.

Чтобы подготовить среду для Azure CLI, выполните указанные ниже действия.

Используйте среду Bash в Azure Cloud Shell. Дополнительные сведения см. в статье "Начало работы с Azure Cloud Shell".
Если вы предпочитаете запускать справочные команды CLI локально, установите Azure CLI. Если вы работаете в Windows или macOS, подумайте о запуске Azure CLI в контейнере Docker. Дополнительные сведения см. в статье Как запустить Azure CLI в контейнере Docker.
- Если вы используете локальную установку, войдите в Azure CLI с помощью команды az login . Чтобы завершить процесс аутентификации, следуйте шагам, отображаемым в вашем терминале. Сведения о других параметрах входа см. в статье "Проверка подлинности в Azure с помощью Azure CLI".
- Когда вас попросят, установите расширение Azure CLI при первом использовании. Дополнительные сведения о расширениях см. в статье Использование расширений и управление ими с помощью Azure CLI.
- Выполните команду az version, чтобы узнать установленную версию и зависимые библиотеки. Чтобы обновиться до последней версии, выполните команду az upgrade.

Выполните команду az datashare consumer-invitation list-invitation, чтобы просмотреть текущие приглашения:

az datashare consumer-invitation list-invitation

Скопируйте идентификатор приглашения для использования в следующем разделе.

Начните с подготовки среды для PowerShell. Вы можете выполнять команды PowerShell локально или использовать среду Bash в Azure Cloud Shell.

Если вы решили использовать Azure PowerShell локально:
- Установите последнюю версию модуля Az PowerShell.
- Подключитесь к учетной записи Azure с помощью командлета Connect-AzAccount.
Если вы решили использовать Azure Cloud Shell:
- Дополнительные сведения см. в статье Общие сведения об Azure Cloud Shell.

Используйте команду Connect-AzAccount для подключения к учетной записи Azure.
```
Connect-AzAccount
```
Выполните команду Set-AzContext , чтобы задать правильную подписку, если у вас несколько подписок.
```
Set-AzContext [SubscriptionID/SubscriptionName]
```
Выполните команду Get-AzDataShareReceivedInvitation , чтобы просмотреть текущие приглашения:
```
Get-AzDataShareReceivedInvitation
```

Скопируйте идентификатор приглашения для использования в следующем разделе.

Принять приглашение

Убедитесь, что все поля проверяются, включая условия использования. Если вы согласны с условиями использования, вам потребуется установить флажок, чтобы указать, что вы согласны.
В разделе "Целевая учетная запись общего доступа к данным" выберите подписку и группу ресурсов, в которую будет развернут общий ресурс данных.

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

Для поля "Полученное имя общего ресурса " можно оставить значение по умолчанию, указанное источником данных, или указать новое имя для общего ресурса.

После того как вы согласились с условиями использования и указали учетную запись Data Share для управления полученным общим доступом, нажмите "Принять и Настроить". Будет создана подписка на акции.

Это действие перенаправляет вас к полученному доступу в учетной записи Data Share.

Если вы не хотите принять приглашение, нажмите кнопку "Отклонить".

Используйте команду az datashare share-subscription create для создания обмена данными.

az datashare share-subscription create --resource-group share-rg \
  --name "fabrikamsolutions" --account-name FabrikamDataShareAccount \
  --invitation-id 89abcdef-0123-4567-89ab-cdef01234567 \
  --source-share-location "East US 2"

Используйте команду New-AzDataShareSubscription для создания подписки на общий доступ к данным. Идентификатор приглашения будет идентификатором, собранным на предыдущем шаге.

New-AzDataShareSubscription -ResourceGroupName share-rg -AccountName FabrikamDataShareAccount -Name "Fabrikam Solutions" -InvitationId "89abcdef-0123-4567-89ab-cdef01234567"

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

Перейдите на вкладку "Наборы данных ". Установите флажок рядом с набором данных, в который вы хотите назначить назначение. Выберите +Сопоставить целевой объект, чтобы выбрать целевое хранилище данных.
Выберите тип целевого хранилища данных, в который вы хотите приземлиться. Все файлы данных или таблицы в целевом хранилище данных с тем же путем и именем будут перезаписаны. Если вы получаете данные в Базе данных SQL Azure или Azure Synapse Analytics (прежнее название — хранилище данных SQL Azure), установите флажок Разрешить общий ресурс данных запускать приведенный выше сценарий создания пользователя от моего имени.

Для общего доступа на месте выберите хранилище данных в указанном расположении. Расположение — это центр обработки данных Azure, где находится исходное хранилище данных поставщика данных. После сопоставления набора данных можно перейти по ссылке в целевом пути, чтобы получить доступ к данным.
Для общего доступа на основе моментальных снимков, если поставщик данных создал расписание моментальных снимков для предоставления регулярного обновления данных, можно также включить расписание моментальных снимков, выбрав вкладку "Расписание моментальных снимков". Установите флажок рядом с расписанием моментальных снимков и нажмите + Включить. Первый запланированный моментальный снимок начнется в течение одной минуты времени расписания, а последующие моментальные снимки будут начинаться в течение нескольких секунд запланированного времени.

Метаданные скопированных файлов не сохраняются после каждого запуска. Это сделано намеренно.

Используйте эти команды для настройки места получения данных.

Выполните команду az datashare consumer-source-data-set list , чтобы получить идентификатор набора данных:

az datashare consumer-source-data-set list --resource-group "share-rg" \
 --account-name "FabrikamDataShareAccount" \
   --share-subscription-name "fabrikamsolutions" \

Если вам нужна учетная запись хранения, выполните команду az storage account create , чтобы создать учетную запись хранения для этой общей папки данных:
```
az storage account create --resource-group "share-rg" --name "FabrikamDataShareStorageAccount" \
```
Используйте команду az storage account show , чтобы получить идентификатор учетной записи хранения:
```
az storage account show --resource-group "share-rg" --name "FabrikamDataShareStorageAccount" \
 --query "id"
```
Чтобы получить идентификатор субъекта учетной записи, используйте следующую команду:
```
az datashare account show --resource-group "share-rg" --name "FabrikamDataShareAccount" \
  --query "identity.principalId"
```
Используйте команду az role assignment create , чтобы создать назначение ролей для субъекта учетной записи с помощью идентификатора субъекта учетной записи и идентификатора учетной записи хранения:
```
az role assignment create --role "Contributor" \
  --assignee-object-id aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb 
  --assignee-principal-type ServicePrincipal --scope "your\storage\account\id\path"
```

Создайте переменную для сопоставления на основе идентификатора набора данных на шаге 1.

$mapping='{\"data_set_id\":\"' + $dataset_id + '\",\"container_name\":\"newcontainer\",
  \"storage_account_name\":\"datashareconsumersa\",\"kind\":\"BlobFolder\",\"prefix\":\"consumer\"}'

Используйте команду az datashare data-set-mapping create для создания сопоставления наборов данных:

az datashare data-set-mapping create --account-name "FabrikamDataShareAccount" \
 --data-set-mapping-name "datasetmapping" --resource-group "share-rg" \
 --share-subscription-name "fabrikamsolutions" --blob-folder-data-set-mapping $mapping

Выполните команду az datashare share-subscription synchronize, чтобы запустить синхронизацию набора данных.
```
az datashare share-subscription synchronize \
  --resource-group "share-rg" --account-name "FabrikamDataShareAccount"  \
  --name "Fabrikam Solutions" --synchronization-mode "Incremental" \
```
Выполните команду az datashare share-subscription list-synchronization , чтобы просмотреть список синхронизаций:
```
az datashare share-subscription list-synchronization \
  --resource-group "share-rg" --account-name "FabrikamDataShareAccount" \
  --share-subscription-name "Fabrikam Solutions" \
```
Используйте команду az datashare share-subscription list-source-share-synchronization-setting, чтобы просмотреть параметры синхронизации, заданные для вашего ресурса обмена.
```
az datashare share-subscription list-source-share-synchronization-setting \
  --resource-group "share-rg" --account-name "FabrikamDataShareAccount" \
  --share-subscription-name "Fabrikam Solutions"
```

Используйте эти команды для настройки места получения данных.

Выполните команду Get-AzDataShareSourceDataSet , чтобы получить идентификатор набора данных:
```
Get-AzDataShareSourceDataSet -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions"
```
Если у вас еще нет расположения, в котором вы хотите хранить общие данные, выполните следующие действия, чтобы создать учетную запись хранения. Если у вас уже есть хранилище, перейдите к следующим шагам.
1. Выполните команду New-AzStorageAccount , чтобы создать учетную запись хранения Azure:
```
$storageAccount = New-AzStorageAccount -ResourceGroupName "share-rg" -AccountName FabrikamStorageAccount -Location "East US 2" -SkuName Standard_GRS

$ctx = $storageAccount.Context
```
2. Выполните команду New-AzStorageContainer , чтобы создать контейнер в новой учетной записи хранения Azure, в которой будут храниться данные:
```
$containerName = "StorageContainer"

New-AzStorageContainer -Name $containerName -Context $ctx -Permission blob
```
3. Выполните команду Set-AzStorageBlobContent , чтобы отправить файл. Следующий пример отправляет textfile.csv из папки D:\testFiles в локальную память в созданный контейнер.
```
Set-AzStorageBlobContent -File "D:\testFiles\textfile.csv" -Container $containerName -Blob "textfile.csv" -Context $ctx
```
Дополнительные сведения о работе с хранилищем Azure в PowerShell см. в этом руководстве по Службе хранилища Azure PowerShell.
Используйте команду Get-AzStorageAccount , чтобы получить идентификатор учетной записи хранения:
```
Get-AzStorageAccount -ResourceGroupName "share-rg" -Name FabrikamStorageAccount
```

Используйте идентификатор набора данных с первого шага, а затем выполните команду New-AzDataShareDataSetMapping , чтобы создать сопоставление наборов данных:

New-AzDataShareDataSetMapping -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions" -Name "Fabrikam Solutions" -StorageAccountResourceId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"  -DataSetId "0123abcd-ef01-2345-6789-abcdef012345"  -Container "StorageContainer"

Выполните команду Start-AzDataShareSubscriptionSynchronization , чтобы начать синхронизацию наборов данных.

Start-AzDataShareSubscriptionSynchronization -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions" -SynchronizationMode "Incremental"

Выполните команду Get-AzDataShareSubscriptionSynchronization , чтобы просмотреть список синхронизаций:

Get-AzDataShareSubscriptionSynchronization -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions"

Используйте команду Get-AzDataShareSubscriptionSynchronizationDetail, чтобы просмотреть параметры синхронизации, заданные на вашем объекте обмена.

Get-AzDataShareSubscriptionSynchronizationDetail -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions" -SynchronizationId "a6ee5c8d-0ce0-485e-b2f2-966b187dc6c7"

Активация создания моментальных снимков

Эти шаги относятся только к совместному использованию, основанному на снимках.

Моментальный снимок можно активировать, выбрав вкладку «Сведения», а затем «Активировать снимок». Здесь вы можете запустить полный или добавочный снимок ваших данных. Если вы впервые получаете данные от поставщика данных, выберите полную копию.
Когда статус последнего запуска — успешный, перейдите в целевое хранилище данных, чтобы просмотреть полученные данные. Выберите наборы данных и выберите ссылку в целевом пути.

Выполните команду az datashare trigger create, чтобы инициировать моментальный снимок:

az datashare trigger create --account-name "FabrikamDataShareAccount" --resource-group "share-rg" --share-subscription-name "Fabrikam Solutions" --scheduled-trigger recurrence-interval="Day" synchronization-mode="Incremental" synchronization-time="2018-11-14T04:47:52.9614956Z" --name "Trigger1"

Эти шаги относятся только к совместному использованию, основанному на снимках.

Выполните команду New-AzDataShareTrigger , чтобы активировать моментальный снимок:

New-AzDataShareTrigger -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -Name "Fabrikam Solutions" -RecurrenceInterval "Day" -SynchronizationTime "2018-11-14T04:47:52.9614956Z"

Просмотр истории

Этот шаг применяется только к совместному использованию на основе снапшотов. Чтобы просмотреть журнал моментальных снимков, перейдите на вкладку "Журнал ". Здесь вы найдете историю всех моментальных снимков, созданных за последние 30 дней.

Очистите ресурсы

Если ресурс больше не нужен, перейдите на страницу обзора общего доступа к данным и выберите "Удалить ", чтобы удалить его.

Дальнейшие шаги

В этом руководстве вы узнали, как принять и получить Обмен данными Azure. Чтобы узнать больше о понятиях Azure Data Share, перейдите к терминологии Azure Data Share.

Основные понятия Общего доступа к данным Azure

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2025-10-08