Получение общей папки хранилища Azure на месте с Общий доступ к данным Microsoft Purview (предварительная версия)

Важно!

Сейчас эта функция доступна в предварительной версии. Дополнительные условия использования предварительных версий Microsoft Azure включают дополнительные юридические условия, применимые к функциям Azure, которые находятся в бета-версии, в предварительной версии или еще не выпущены в общедоступной версии.

Общий доступ к данным Microsoft Purview поддерживает общий доступ к данным на месте из Azure Data Lake Storage (ADLS 2-го поколения) в ADLS 2-го поколения, а учетная запись хранения BLOB-объектов — в учетную запись хранения BLOB-объектов. В этой статье объясняется, как получить общий доступ и получить доступ к общим данным.

Примечание.

Эта функция была обновлена в феврале 2023 г., а разрешения, необходимые для просмотра и управления общим доступом к данным в Microsoft Purview, изменились. Теперь для коллекции, в которой размещены общие данные, требуются только разрешения читателя. Дополнительные сведения о коллекции и ролях Microsoft Purview см. в разделе Разрешения Microsoft Purview .

Предварительные требования для получения общих данных

Предварительные требования к Microsoft Purview

• Учетная запись Microsoft Purview.
• Минимальная роль читателя данных в коллекции Microsoft Purview для использования пользовательского интерфейса обмена данными на портале управления Microsoft Purview. Дополнительные сведения о коллекции и ролях Microsoft Purview см. в разделе Разрешения Microsoft Purview .
• Для использования пакета SDK разрешение Microsoft Purview не требуется.

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

• Подписка Azure должна быть зарегистрирована для предварительной версии функции AllowDataSharing . Выполните следующие действия с помощью портал Azure или PowerShell.

  Портал

  1. В портал Azure выберите подписку Azure, которая используется для создания исходной и целевой учетной записи хранения.
  2. В меню слева выберите Предварительный просмотр функций в разделе Параметры.
  3. Выберите AllowDataSharing и Register (Зарегистрировать).
  4. Обновите экран предварительных версий функций , чтобы убедиться, что состояниезарегистрировано. Регистрация может занять от 15 минут до 1 часа.
  5. Кроме того, чтобы использовать общий ресурс данных для учетных записей хранения в восточной части США, восточной части США2, Северной Европе, центрально-южной части США, центрально-западной части США, Западной Европе, западной части США, западной части США2, западной части США3, выберите AllowDataSharingInHeroRegion и Зарегистрировать

  Дополнительные сведения см. в статье Регистрация предварительной версии функции.

  PowerShell

  Set-AzContext -SubscriptionId [Your Azure subscription ID]
  

  Register-AzProviderFeature -FeatureName "AllowDataSharing" -ProviderNamespace "Microsoft.Storage"
  

  Get-AzProviderFeature -FeatureName "AllowDataSharing" -ProviderNamespace "Microsoft.Storage"   
  

  Кроме того, чтобы использовать общую папку данных для учетных записей хранения в восточной части США, восточной части США2, Северной Европе, южной центральной части США, центрально-западной части США, Западной Европе, западной части США и западной части США2:

  Register-AzProviderFeature -FeatureName "AllowDataSharingInHeroRegion" -ProviderNamespace "Microsoft.Storage"
  

  Get-AzProviderFeature -FeatureName "AllowDataSharingInHeroRegion" -ProviderNamespace "Microsoft.Storage"   
  

  Значение RegistrationState должно быть Зарегистрировано. Регистрация может занять от 15 минут до 1 часа. Дополнительные сведения см. в статье Регистрация предварительной версии функции.

  Примечание.

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

  • Регионы Azure: Центральная Канада, Восточная Канада, Южная Часть Соединенного Королевства, Западная Часть Соединенного Королевства, Восточная Австралия, Восточная Япония, Южная Корея и Северная Африка
  • Дополнительные регионы Azure: восточная часть США, восточная часть США2, Северная Европа, юго-центральная часть США, центрально-западная часть США, Западная Европа, Западная часть США, Западная часть США 2, Западная часть США3
  • Производительность: стандартная
  • Параметры избыточности: LRS

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

  Важно!

  Целевая учетная запись хранения должна находиться в том же регионе Azure, что и исходная учетная запись хранения.

• В целевой учетной записи хранения требуется роль "Участник", "Владелец" или "Владелец данных BLOB-объектов хранилища" или "Участник данных BLOB-объектов хранилища". Дополнительные сведения см. на страницах источника данных ADLS 2-го поколения или хранилища BLOB-объектов .

• Если целевая учетная запись хранения находится в подписке Azure, отличной от учетной записи Microsoft Purview, Microsoft.Purview поставщик ресурсов должен быть зарегистрирован в подписке Azure, где находится учетная запись хранения. Он автоматически регистрируется во время присоединения общей папки потребителя к общей папке и, если у пользователя есть разрешение на выполнение /register/action операции и, следовательно, роли участника или владельца для подписки, в которой находится учетная запись хранения. Эта регистрация требуется только в первый раз при совместном использовании или получении данных в учетной записи хранения в подписке Azure.

• Учетная запись хранения должна быть зарегистрирована в коллекции, в которой вы получите общую папку. Инструкции по регистрации см. на страницах источников данных ADLS 2-го поколения или хранилища BLOB-объектов . Этот шаг не требуется для использования пакета SDK.

• Последняя версия пакета SDK для хранилища, PowerShell, CLI и Обозреватель службы хранилища Azure. Версия REST API хранилища должна быть от февраля 2020 г. или более поздней.

Получение общего ресурса

1. Вы можете просматривать приглашения на общий доступ в любой учетной записи Microsoft Purview. Откройте портал управления Microsoft Purview, перейдя непосредственно на классический портал или новый портал Microsoft Purview и выбрав учетную запись Microsoft Purview.

2. На классическом портале щелкните значок Карта данных в области навигации слева. На новом портале перейдите к приложению Каталог данных.

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

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

   

4. Кроме того, на портале Microsoft Purview найдите ресурс данных службы хранилища Azure или Azure Data Lake Storage (ADLS) 2-го поколения, в который вы хотите получить общую папку, с помощью поиска или просмотракаталога данных. Нажмите кнопку Data Share. Все приглашения отображаются на вкладке Общий доступ к приглашениям .

5. Выберите имя приглашения на общий доступ для просмотра или настройки.

6. Если вы не хотите принимать приглашение, нажмите кнопку Удалить.

   

   Примечание.

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

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

   Важно!

   Целевая учетная запись хранения должна находиться в том же регионе Azure, что и исходная учетная запись хранения.

8. Настройте путь (новое имя контейнера или имя существующего контейнера общей папки) и Новую папку (новое имя папки для общей папки в контейнере).

9. Выберите Присоединиться к целевому объекту.

   

10. На странице Управление общими папками данных вы увидите новую общую папку с состоянием Присоединение , пока она не будет завершена и присоединена.

    

11. Доступ к общим данным из целевой учетной записи хранения можно получить через портал Azure, Обозреватель службы хранилища Azure, пакет SDK службы хранилища Azure, PowerShell или CLI. Вы также можете проанализировать общие данные, подключив учетную запись хранения к Azure Synapse Analytics Spark или Databricks.

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

Дополнительные сведения об общих ресурсах и происхождении данных см. в разделе Общий доступ к данным Microsoft Purview происхождения данных.

Примечание.

Общие папки, присоединенные с помощью пакета SDK без регистрации учетной записи хранения в Microsoft Purview, не будут приниматься в каталог. При необходимости пользователь может зарегистрировать свою учетную запись хранения. Если учетная запись хранения не зарегистрирована или повторно зарегистрирована в другой коллекции, общий доступ к ресурсам этой учетной записи хранения по-прежнему находится в первоначальной коллекции.

Обновление полученного общего ресурса

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

Вы можете найти и изменить полученный общий ресурс одним из двух способов:

• Перейдите к хранилищу BLOB-объектов или ресурсу ADLS 2-го поколения, где были получены данные в каталоге данных, и откройте их, а затем выберите Data Share и Управление общими папками данных. Там вы можете увидеть все общие папки для этого ресурса. Перейдите на вкладку Полученные общие папки , выберите общую папку, а затем выберите свою общую папку.

  

  

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

  

Повторное присоединение общего ресурса

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

Если вы обновляете целевой объект, выберите Присоединить к целевому объекту , чтобы сохранить изменения. После начала процесса подключение может занять несколько минут.

Примечание.

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

Удаление полученной общей папки

Чтобы удалить полученную общую папку, выберите общую папку и нажмите кнопку Удалить.

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

Проверка гостевого пользователя

Если вы являетесь гостевым пользователем в Azure, для получения общих папок ваша учетная запись должна быть сначала связана с Azure Active Directory. Этот процесс можно запустить в Microsoft Purview.

1. На портале управления Microsoft Purview выберите Карту данных, а затем — Поделиться приглашениями.

2. Вы увидите текст, указывающий, что необходимо связать с Azure Active Directory. Нажмите кнопку Получить код проверки .

   

3. Вы получите сообщение электронной почты от Microsoft Azure с кодом проверки. Скопируйте его.

4. Вернитесь на страницу Общий доступ к приглашениям на портале управления Microsoft Purview, выберите Проверить и введите полученный код.

Устранение неполадок

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

Не удается создать учетную запись Microsoft Purview

Если при создании учетной записи Microsoft Purview возникает ошибка, связанная с квотой , это означает, что ваша организация превысила ограничение службы Microsoft Purview. Если требуется увеличить ограничение, обратитесь в службу поддержки.

Не удается найти ресурс учетной записи хранения в каталоге

• Источник данных не зарегистрирован в Microsoft Purview. См. инструкции по регистрации хранилища BLOB-объектов и ADLSGen2 соответственно. Выполнение сканирования не требуется.
• Источник данных регистрируется в коллекции Microsoft Purview, для которых у вас нет минимального разрешения на чтение данных. Ознакомьтесь с разрешениями каталога Microsoft Purview и обратитесь к администратору коллекции для получения доступа.

Не удается просмотреть список общих папок в ресурсе учетной записи хранения

• Выдача разрешений для хранилища данных, для которого требуется просмотреть общие папки. Вам требуется как минимум роль читателя в исходной учетной записи хранения, чтобы просмотреть представление отправленных общих папок и полученных общих папок только для чтения. Дополнительные сведения см. на странице источника данных ADLS 2-го поколения или хранилища BLOB-объектов .

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

• Возможно, вы выбрали другую учетную запись хранения для присоединения к общей папке, которая может быть не зарегистрирована в Microsoft Purview или, возможно, зарегистрирована в коллекции, на которую у вас нет разрешений. См. инструкции по регистрации хранилища BLOB-объектов и ADLSGen2 соответственно. Ознакомьтесь с разрешениями каталога Microsoft Purview и обратитесь к администратору коллекции, чтобы получить доступ к коллекциям.

Не удается просмотреть приглашение на общий доступ

Если вы получили уведомление о том, что получили общий доступ, но не можете просмотреть приглашение на общий доступ в учетной записи Microsoft Purview, это может быть вызвано следующими причинами:

• У вас нет минимальной роли читателя данных для каких-либо коллекций в этой учетной записи Microsoft Purview. Обратитесь к Администратор коллекции Microsoft Purview, чтобы предоставить вам доступ к роли читателя данных для просмотра, принятия и настройки полученного общего ресурса.
• Приглашение на общий доступ отправляется на ваш псевдоним электронной почты или группу рассылки электронной почты, а не на адрес электронной почты для входа в Azure. Обратитесь к поставщику данных и убедитесь, что он отправил приглашение на ваш адрес электронной почты для входа в Azure.
• Общий доступ уже принят. Если вы уже приняли общий доступ, он больше не будет отображаться на вкладке "Поделиться приглашениями ". Выберите Полученные общие папки в любой учетной записи хранения, на которую у вас есть разрешения, и просмотрите активные общие папки.
• Вы являетесь гостевым пользователем клиента. Если вы являетесь гостевым пользователем клиента, необходимо проверить адрес электронной почты клиента, чтобы в первый раз просмотреть приглашение общего доступа. После проверки он действителен в течение 12 месяцев.

Не удается увидеть целевую учетную запись хранения в списке при присоединении общей папки

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

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

Не удалось присоединить общий ресурс

Если не удалось присоединить общий ресурс, это, скорее всего, связано со следующими причинами:

• Проблема с разрешением для целевого хранилища данных. Проверьте необходимые разрешения для хранилища данных.
• Учетная запись хранения не поддерживается. Общий ресурс данных Microsoft Purview поддерживает только учетные записи хранения с определенными конфигурациями.
• Указанный путь включает контейнер, созданный за пределами Общий доступ к данным Microsoft Purview. Данные можно получать только в контейнеры, созданные во время присоединения.
• Новая папка, указанная для получения данных хранилища, не пуста.
• Исходная и целевая учетные записи хранения совпадают. Общий доступ из одной исходной учетной записи хранения к тому же целевому объекту не поддерживается.
• Превышение предела. Исходная учетная запись хранения может поддерживать до 20 целевых объектов, а целевая учетная запись хранения — до 100 источников. Если требуется увеличить ограничение, обратитесь в службу поддержки.

Не удается получить доступ к общим данным в целевом хранилище данных

Если вы не можете получить доступ к общим данным, это, скорее всего, по следующим причинам:

• После успешного подключения к общей папке может потребоваться некоторое время, чтобы данные отображались в целевом хранилище данных. Повторите попытку через несколько минут. Аналогичным образом, после удаления общей папки может потребоваться несколько минут, чтобы данные исчезли в целевом хранилище данных.
• Вы обращаетесь к общим данным с помощью версии API хранилища до февраля 2020 г. Для доступа к общим данным поддерживаются только API хранилища за февраль 2020 г. и более поздних версий. Убедитесь, что используется последняя версия пакета SDK для хранилища, PowerShell, CLI и Обозреватель службы хранилища Azure.
• Вы обращаетесь к общим данным с помощью средства аналитики, которое использует версию API хранилища до февраля 2020 г. Вы можете получить доступ к общим данным из Azure Synapse Analytics Spark и Databricks. Вы не сможете получить доступ к общим данным с помощью Фабрика данных Azure, Power BI или AzCopy.

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

• Предоставление общего доступа к данным
• Вопросы и ответы по обмену данными
• Ссылка на API REST