Condividi tramite


Creare un collegamento rapido a Google Cloud Storage (GCS)

Questo articolo spiega come creare un collegamento a Google Cloud Storage (GCS) all’interno di un lakehouse di Fabric. È possibile creare collegamenti a Google Cloud Storage (GCS) usando l'API XML per GCS. Quando si creano collegamenti a Google Cloud Storage, il percorso di destinazione deve contenere almeno un nome di bucket. È inoltre possibile limitare l'ambito del collegamento specificando meglio il prefisso o la cartella a cui puntare all'interno della gerarchia di archiviazione.

Le scorciatoie GCS sono di sola lettura. Non supportano operazioni di scrittura indipendentemente dalle autorizzazioni dell'utente.

Per le informazioni generali sui collegamenti, vedere Collegamenti di OneLake. Per programmare la creazione di collegamenti, vedere API REST per collegamenti a OneLake.

Le scorciatoie GCS possono sfruttare la memorizzazione dei file nella cache per ridurre i costi di uscita associati all'accesso inter-cloud ai dati. Per ulteriori informazioni, vedere Scorciatoie di OneLake > memorizzazione nella cache.

Prerequisiti

Creare un collegamento

  1. Aprire una casa sul lago.

  2. Fare clic con il pulsante destro del mouse su una directory all'interno della vista lago della lakehouse.

  3. Selezionare Nuovo collegamento.

    Screenshot del menu di scelta rapida con il pulsante destro del mouse che mostra dove selezionare Nuovo collegamento dalla Lake view.

Selezionare un'origine

  1. In Origini esterne, selezionare Google Cloud Storage.

    Screenshot della finestra Nuovo collegamento che mostra i tipi di collegamento disponibili. L’opzione denominata Google Cloud Storage è evidenziata.

  2. Immettere le Impostazioni di connessione in base alla tabella seguente:

    Screenshot della finestra Nuovo collegamento che mostra le impostazioni di Collegamento e le credenziali di Collegamento.

    Campo Descrizione Value
    URL La stringa di connessione per il bucket GCS. Il nome del bucket è facoltativo. https:// BucketName.storage.googleapis.comhttps://storage.googleapis.com
    Connessione I collegamenti definiti in precedenza per il percorso di archiviazione specificato vengono visualizzati nell'elenco a tendina. Se non esistono collegamenti, crearne uno nuovo. Creare nuovo collegamento
    Nome connessione Il nome della connessione definito dall’utente. Un nome per la connessione.
    Tipo di autenticazione Fabric usa chiavi Hash-based Message Authentication Code (HMAC) per accedere a Google Cloud Storage. Queste chiavi sono associate a un account utente o di servizio. L'account deve disporre dell'autorizzazione per accedere ai dati all'interno del bucket GCS. Se l'endpoint specifico del bucket è stato usato nell'URL di connessione, l'account deve avere le autorizzazioni storage.objects.get e storage.objects.list. Se l'endpoint globale è stato usato nell'URL di connessione, l'account deve avere anche l’autorizzazione storage.buckets.list. Chiave HMAC
    ID di accesso La chiave di accesso associata a un account utente o di servizio. Per altre informazioni sulla creazione di chiavi HMAC, vedere Gestire le chiavi HMAC. La chiave di accesso.
    Segreto Il segreto per la chiave di accesso. La chiave privata.
  3. Selezionare Avanti.

  4. Navigare fino alla posizione di destinazione per il collegamento.

    Screenshot della finestra di esplorazione dell'archiviazione con più cartelle selezionate.

    Se è stato usato l'endpoint globale nell'URL di collegamento, tutti i bucket disponibili compaiono nella vista di navigazione a sinistra. Se è stato usato un endpoint specifico del bucket nell'URL di collegamento, nella vista di navigazione compaiono solo il bucket specifico e il relativo contenuto.

    Spostarsi nell'account di archiviazione selezionando una cartella o cliccando sulla freccia di espansione accanto a una cartella.

    In questa visualizzazione è possibile selezionare una o più posizioni di destinazione delle scorciatoie. Scegliere le posizioni di destinazione facendo clic sulla casella di controllo accanto a una cartella nella visualizzazione di spostamento a sinistra.

  5. Selezionare Avanti

    Screenshot della pagina di revisione dei collegamenti con le opzioni per rinominare ed eliminare i collegamenti.

    La pagina di revisione consente di verificare tutte le selezioni. Qui è possibile visualizzare ogni scorciatoia che verrà creata. Nella colonna azione è possibile fare clic sull'icona a forma di matita per modificare il nome del collegamento. È possibile fare clic sull'icona del cestino per eliminare il collegamento.

  6. Fare clic su Crea.

La casa sul lago si aggiorna automaticamente. Il collegamento compare nel riquadro Esplora risorse a sinistra.

Screenshot che mostra un elenco di tabelle in visualizzazione Lake che visualizzano il simbolo di scelta rapida.

Accesso

Quando si configura la connessione per un collegamento GCS, è possibile specificare l'endpoint globale per il servizio di archiviazione o usare un endpoint specifico per il bucket.

  • Esempio di endpoint globale: https://storage.googleapis.com
  • Esempio di endpoint specifico del bucket: https://<BucketName>.storage.googleapis.com

Authorization

Le scorciatoie GCS usano un modello di autorizzazione delegata. In questo modello, l'autore dei collegamenti specifica una credenziale per il collegamento GCS e l'intero accesso a tale collegamento è autorizzato usando tale credenziale. Le credenziali delegate supportate sono una chiave HMAC e un segreto per un account di servizio o un account utente.

L'account deve disporre dell'autorizzazione per accedere ai dati all'interno del bucket GCS. Se nella connessione della scorciatoia è stato usato l'endpoint specifico del bucket, l'account deve disporre delle seguenti autorizzazioni:

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

Se nella connessione per il collegamento è stato usato l'endpoint globale, l'account deve anche disporre della seguente autorizzazione:

  • storage.buckets.list

Limitazioni

Le limitazioni seguenti si applicano alle scorciatoie di Google Cloud Storage:

  • Le scorciatoie GCS sono di sola lettura. Non supportano operazioni di scrittura indipendentemente dalle autorizzazioni dell'utente.