Создайте ярлык для Google Cloud Storage (GCS)

В этой статье вы узнаете, как создать ссылку на Google Cloud Storage (GCS) в lakehouse Fabric. Ярлыки можно создать в Google Cloud Storage(GCS) с помощью XML-API для GCS. При создании ярлыков в Google Cloud Storage целевой путь должен содержать имя хранилища как минимум. Кроме того, можно ограничить область ярлыка, указав дополнительно префикс/папку, на которую нужно указать в иерархии хранилища.

Ярлыки GCS доступны только для чтения. Они не поддерживают операции записи независимо от разрешений пользователя.

Общие сведения о сочетаниях клавиш см. в разделе "Сочетания клавиш OneLake". Для программного создания ярлыков см. REST API для ярлыков OneLake.

Упрощенные методы GCS могут использовать кэширование файлов для снижения затрат на исходящий трафик, связанных с доступом к данным между облачными сервисами. Дополнительные сведения см. в разделе "Кэширование ярлыков > OneLake".

Предварительные условия

Создайте ярлык

  1. Откройте дом у озера.

  2. Щелкните правой кнопкой мыши каталог в представлении Lake view озера.

  3. Выберите Новый ярлык.

    Снимок экрана: контекстное меню правой кнопкой мыши, в котором показано, где выбрать новый ярлык в представлении Lake.

Выбор источника

  1. В разделе "Внешние источники" выберите Google Cloud Storage.

    Снимок экрана: окно создания ярлыка с доступными типами ярлыков. Выделен параметр Google Cloud Storage.

  2. Введите параметры подключения в соответствии со следующей таблицей:

    Снимок экрана окна нового ярлыка, показывающего параметры подключения и учетные данные подключения.

    Поле Описание Значение
    URL-адрес Строка подключения для контейнера GCS. Имя контейнера необязательно. https:// .storage.googleapis.com Имя контейнера https://storage.googleapis.com
    Соединение Ранее определенные подключения для указанного расположения хранилища отображаются в раскрывающемся списке. Если подключения отсутствуют, создайте новое подключение. Создание нового подключения
    Имя подключения Определяемое пользователем имя подключения. Имя для вашего подключения.
    Тип проверки подлинности Fabric использует ключи на основе хэш-кода проверки подлинности сообщений (HMAC) для доступа к хранилищу Google Cloud. Эти ключи связаны с учетной записью пользователя или службы. Учетная запись должна иметь разрешение на доступ к данным в контейнере GCS. Если в URL-адресе подключения использовалась определенная конечная точка контейнера, учетная запись должна иметь storage.objects.get и storage.objects.list разрешения. Если в URL-адресе подключения использовалась глобальная конечная точка, учетная запись должна также иметь разрешение storage.buckets.list. Ключ HMAC
    Идентификатор доступа Ключ доступа, связанный с учетной записью пользователя или службы. Дополнительные сведения о создании ключей HMAC см. в разделе "Управление ключами HMAC". Ключ доступа.
    Секрет Секрет ключа доступа. Секретный ключ.
  3. Выберите Далее.

  4. Перейдите к целевому расположению ярлыка.

    Снимок экрана: окно обзора хранилища с выбранными несколькими папками.

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

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

    В этом представлении можно выбрать одно или несколько целевых расположений для ярлыков. Выберите целевые расположения, нажав флажок рядом с папкой в представлении навигации слева.

  5. Выберите Далее

    Снимок экрана: страница просмотра ярлыков с параметрами переименования и удаления ярлыков.

    Страница проверки позволяет проверить все выбранные элементы. Здесь вы можете увидеть каждый ярлык, который будет создан. В столбце действия щелкните значок карандаша, чтобы изменить имя ярлыка. Чтобы удалить этот ярлык, щелкните значок мусорной корзины.

  6. Нажмите кнопку создания.

Дом у озера автоматически обновляется. Ярлык отображается в левой области обозревателя .

Снимок экрана списка таблиц представлений озера, которые отображают символ ярлыка.

Доступ

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

  • Пример глобальной конечной точки: https://storage.googleapis.com
  • Пример конечной точки для конкретного контейнера: https://<BucketName>.storage.googleapis.com

Authorization

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

Учетная запись должна иметь разрешение на доступ к данным в контейнере GCS. Если в соединении для ярлыка использовалась конечная точка, специфичная для bucket'а, учетная запись должна иметь следующие разрешения:

  • storage.objects.get
  • storage.objects.list

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

  • storage.buckets.list

Ограничения

Следующие ограничения применяются к сочетаниям клавиш Google Cloud Storage:

  • Ярлыки GCS доступны только для чтения. Они не поддерживают операции записи независимо от разрешений пользователя.