Buat pintasan Google Cloud Storage (GCS)

Dalam artikel ini, Anda akan mempelajari cara membuat pintasan Google Cloud Storage (GCS) di dalam Fabric lakehouse. Pintasan ke Google Cloud Storage (GCS) dapat dibuat menggunakan XML API untuk GCS. Saat Anda membuat pintasan ke Google Cloud Storage, jalur target harus berisi nama bucket minimal. Anda juga dapat membatasi cakupan pintasan dengan menentukan lebih lanjut awalan/folder yang ingin Anda arahkan dalam hierarki penyimpanan.

Pintasan GCS hanya dapat dibaca. Mereka tidak mendukung operasi tulis terlepas dari izin pengguna.

Untuk gambaran umum pintasan, lihat Pintasan OneLake. Untuk membuat pintasan secara programatik, lihat API REST pintasan OneLake.

Pintasan GCS dapat memanfaatkan caching file untuk mengurangi biaya keluaran yang terkait dengan akses data lintas cloud. Untuk informasi selengkapnya, lihat Penembolokan > pintasan OneLake.

Prasyarat

  • Jika Anda tidak memiliki lakehouse, buat dengan mengikuti langkah-langkah berikut: Buat lakehouse.

  • Pastikan wadah dan pengguna GCS yang Anda pilih memenuhi persyaratan akses dan otorisasi untuk pintasan GCS.

Membuat jalan pintas

  1. Buka lakehouse.

  2. Klik kanan pada direktori dalam Tampilan Danau lakehouse.

  3. Pilih Pintasan Baru.

    Cuplikan layar menu konteks klik kanan memperlihatkan tempat untuk memilih Pintasan baru dari tampilan Lake.

Pilih sumber

  1. Di bawah Sumber eksternal, pilih Google Cloud Storage.

    Cuplikan layar jendela Pintasan baru memperlihatkan jenis pintasan yang tersedia. Opsi berjudul Google Cloud Storage disorot.

  2. Masukkan Pengaturan koneksi sesuai dengan tabel berikut ini:

    Cuplikan layar jendela Pintasan baru memperlihatkan pengaturan Koneksi dan kredensial Koneksi.

    Bidang Deskripsi Value
    URL String koneksi untuk bucket GCS Anda. Nama wadah bersifat opsional. https:// BucketName.storage.googleapis.comhttps://storage.googleapis.com
    Koneksi Koneksi yang ditentukan sebelumnya untuk lokasi penyimpanan yang ditentukan muncul di menu drop-down. Jika tidak ada koneksi, buat koneksi baru. Membuat koneksi baru
    Nama koneksi Nama yang ditentukan pengguna untuk koneksi. Nama untuk koneksi Anda.
    Jenis autentikasi Fabric menggunakan kunci Kode Autentikasi Pesan berbasis Hash (HMAC) untuk mengakses penyimpanan Google Cloud. Kunci ini dikaitkan dengan pengguna atau akun layanan. Akun harus memiliki izin untuk mengakses data dalam wadah GCS. Jika titik akhir khusus bucket digunakan dalam URL koneksi, akun harus memiliki izin storage.objects.get dan storage.objects.list. Jika endpoint global digunakan dalam URL koneksi, akun juga harus memiliki izin storage.buckets.list. Kunci HMAC
    ID Akses Kunci akses yang terkait dengan pengguna atau akun layanan. Untuk informasi selengkapnya tentang membuat kunci HMAC, lihat Mengelola Kunci HMAC. Kunci akses Anda.
    Rahasia Rahasia untuk kunci akses. Kunci rahasiamu.
  3. Pilih Selanjutnya.

  4. Jelajahi ke lokasi yang dituju untuk pintasan.

    Cuplikan layar jendela penjelajahan penyimpanan dengan beberapa folder dipilih.

    Jika Anda menggunakan titik akhir global di URL koneksi, semua wadah yang tersedia muncul di tampilan navigasi kiri. Jika Anda menggunakan titik akhir khusus wadah di URL koneksi, hanya wadah yang ditentukan dan kontennya yang muncul dalam tampilan navigasi.

    Navigasikan akun penyimpanan dengan memilih folder atau mengklik panah ekspansi di samping folder.

    Dalam tampilan ini, Anda dapat memilih satu atau beberapa lokasi target pintasan. Pilih lokasi target dengan mengklik kotak centang di samping folder di tampilan navigasi kiri.

  5. Pilih Selanjutnya

    Cuplikan layar halaman tinjauan pintasan dengan opsi untuk mengganti nama dan menghapus pintasan.

    Halaman tinjauan memungkinkan Anda memverifikasi semua pilihan Anda. Di sini Anda dapat melihat setiap pintasan yang akan dibuat. Di kolom tindakan, Anda dapat mengklik ikon pensil untuk mengedit nama pintasan. Anda dapat mengklik ikon tempat sampah untuk menghapus pintasan.

  6. Pilih Buat.

Lakehouse akan menyegarkan secara otomatis. Pintasan muncul di panel Penjelajah kiri.

Cuplikan layar memperlihatkan daftar tampilan Lake tabel yang menampilkan simbol pintasan.

Akses

Saat mengonfigurasi koneksi untuk pintasan GCS, Anda dapat menentukan titik akhir global untuk layanan penyimpanan atau menggunakan titik akhir khusus wadah.

  • Contoh titik akhir global: https://storage.googleapis.com
  • Contoh titik akhir khusus bucket: https://<BucketName>.storage.googleapis.com

Authorization

Pintasan GCS menggunakan model otorisasi yang didelegasikan. Dalam model ini, pembuat pintasan menentukan kredensial untuk pintasan GCS dan semua akses ke pintasan tersebut diotorisasi menggunakan kredensial tersebut. Kredensial yang didelegasikan yang didukung adalah kunci dan rahasia HMAC untuk akun Layanan atau Akun pengguna.

Akun harus memiliki izin untuk mengakses data dalam wadah GCS. Jika titik akhir khusus bucket digunakan dalam koneksi untuk pintasan, akun harus memiliki izin berikut:

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

Jika titik akhir global digunakan dalam koneksi untuk pintasan, akun juga harus memiliki izin berikut:

  • storage.buckets.list

Keterbatasan

Batasan berikut berlaku untuk pintasan Google Cloud Storage:

  • Pintasan GCS hanya dapat dibaca. Mereka tidak mendukung operasi tulis terlepas dari izin pengguna.