Устранение распространенных неполадок в Azure Data Share

В этой статье объясняется, как устранять распространенные проблемы в Azure Data Share.

Приглашения Azure Data Share

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

  • Служба Azure Data Share не зарегистрирована в качестве поставщика ресурсов для любой подписки Azure в клиенте Azure. Эта проблема возникает, если у клиента Azure нет ресурса Data Share.

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

    1. На портале Azure перейдите к разделу Подписки.
    2. Выберите подписку для создания ресурса Azure Data Share.
    3. Выбрать Поставщики ресурсов.
    4. Выполните поиск Microsoft.DataShare.
    5. Выберите Зарегистрировать.
  • Приглашение отправляется в псевдоним электронной почты вместо адреса электронной почты для входа в Azure. Если вы уже зарегистрировали службу Azure Data Share или создали ресурс Data Share в клиенте Azure, но по-прежнему не видите приглашение, возможно, в качестве получателя указан ваш псевдоним электронной почты. Обратитесь к поставщику данных и убедитесь, что приглашение отправлено на ваш адрес электронной почты для входа в Azure, а не на псевдоним адреса.

  • Приглашение уже принято. Ссылка в сообщении электронной почты открывает страницу приглашения Data Share на портале Azure. На этой странице перечислены только ожидающие приглашения. Принятые приглашения не отображаются. Чтобы просмотреть полученные общие папки и настроить целевой параметр кластера Azure Data Explorer, перейдите к ресурсу Data Share, который вы использовали для принятия приглашения.

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

Создание и получение общих папок

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

  • Не удалось добавить наборы данных.
  • Не удалось сопоставить наборы данных.
  • Не удалось предоставить ресурсу Data Share х доступ к y.
  • У вас нет соответствующих разрешений на x.
  • Не удалось добавить разрешения на запись для учетной записи Azure Data Share в один или несколько выбранных ресурсов.

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

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

Если вы впервые предоставляет совместный доступ или получаете данные из хранилища данных Azure, вам также потребуется разрешение Microsoft.Authorization/role assignments/write. Это разрешение обычно является частью роли владельца. Даже если вы создали ресурс хранилища данных Azure, вы не обязательно являетесь владельцем этого ресурса.

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

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

Моментальные снимки

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

Обычно сбой моментального снимка происходит по следующим причинам:

  • У Data Share нет разрешения на чтение из исходного хранилища данных или на запись в целевое хранилище. Дополнительные сведения см. в разделе Роли и требования. Если вы создаете моментальный снимок в первый раз, то для получения доступа ресурса Data Share к хранилищу данных Azure может потребоваться несколько минут. Подождите несколько минут и повторите попытку.
  • Подключение Data Share к данным к исходному или целевому хранилищу данных блокируется брандмауэром.
  • Общий набор данных, исходное хранилище данных или целевое хранилище данных удалены.

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

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

  • Не запущен SQL-скрипт исходного или целевого хранилища, предоставляющий разрешение на доступ к данным. Или для База данных SQL Azure или Azure Synapse Analytics (прежнее название — хранилище данных SQL Azure), скрипт выполняется с помощью проверки подлинности SQL, а не проверки подлинности Microsoft Entra. Можно выполнить приведенный ниже запрос, чтобы проверить, имеет ли учетная запись Data Share правильное разрешение на доступ к базе данных SQL. Для исходной базы данных SQL в результатах запроса должна отображаться учетная запись Data Share, имеющая роль db_datareader. Для целевой базы данных SQL в результатах запроса должна отображаться учетная запись Data Share, имеющая роли db_datareader, db_datawriter и db_dlladmin.

        SELECT DP1.name AS DatabaseRoleName,
        isnull (DP2.name, 'No members') AS DatabaseUserName
        FROM sys.database_role_members AS DRM
        RIGHT OUTER JOIN sys.database_principals AS DP1
        ON DRM.role_principal_id = DP1.principal_id
        LEFT OUTER JOIN sys.database_principals AS DP2
        ON DRM.member_principal_id = DP2.principal_id
        WHERE DP1.type = 'R'
        ORDER BY DP1.name; 
    
  • Исходное или целевое хранилище данных SQL приостановлены.

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

  • Исходное хранилище данных или целевое хранилище данных SQL заблокированы другими процессами. Azure Data Share не блокирует эти хранилища данных. Но их существующие блокировки могут привести к сбою создания моментального снимка.

  • На целевую таблицу SQL ссылается ограничение внешнего ключа. Если во время создания моментального снимка целевая таблица имеет то же имя, что и таблица в источнике данных, то Azure Data Share удаляет эту таблицу и создает новую. Если на целевую таблицу SQL ссылается ограничение внешнего ключа, ее нельзя удалить.

  • Целевой CSV-файл создается, но данные не могут быть прочитаны в Excel. Эта проблема может возникать, если исходная таблица SQL содержит данные с символами, не принадлежащими английскому языку. В Excel откройте вкладку Получение данных и выберите CSV-файл. Выберите источник файла 65001: Юникод (UTF-8), а затем загрузите данные.

Обновление расписания моментальных снимков

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

общий доступ на месте.

Сопоставление набора данных может завершиться сбоем для кластеров Azure Data Explorer по следующим причинам.

  • У пользователя нет разрешения на запись в кластер azure Data Обозреватель. Это разрешение обычно является частью роли участника.
  • Исходный или целевой кластер Azure Data Explorer приостановлен.
  • Исходным кластером Azure Data Explorer является EngineV2, цель — EngineV3, или наоборот. Совместное использование между кластерами данных Azure Обозреватель различных версий подсистемы не поддерживается.

Следующие шаги

Ознакомьтесь с практическим руководством Предоставление общего доступа к данным.

Информацию о получении данных см. в руководстве Прием и получение данных.