Menerbitkan notebook ke galeri notebook Azure Cosmos DB

  • Artikel
  • 3 menit untuk membaca

BERLAKU UNTUK: SQL API

Notebooks Jupyter bawaan Azure Cosmos DB langsung diintegrasikan ke dalam akun Azure Cosmos DB Anda di portal Microsoft Azure. Dengan menggunakan notebook ini, Anda dapat menganalisis dan memvisualisasikan data Anda dari portal Microsoft Azure. Notebook bawaan untuk Azure Cosmos DB saat ini tersedia di berbagai wilayah. Untuk menggunakan notebook, buat akun Cosmos baru atau aktifkan notebook pada akun lama di salah satu wilayah ini.

Lingkungan notebook di portal Microsoft Azure memiliki beberapa sampel yang diterbitkan oleh tim Azure Cosmos DB. Lingkungan notebook ini juga memiliki galeri publik tempat Anda dapat menerbitkan dan berbagi notebook Anda sendiri. Setelah notebook diterbitkan ke galeri, notebook tersedia bagi semua pengguna Azure Cosmos DB untuk ditampilkan dan digunakan. Dalam artikel ini, Anda akan mempelajari cara menggunakan notebook dari galeri publik dan menerbitkan notebook Anda ke galeri.

Gunakan langkah-langkah berikut ini untuk menampilkan dan mengunduh notebook dari galeri ke ruang kerja notebook Anda sendiri:

  1. Masuk ke portal Microsoft Azure dan buka akun Azure Cosmos DB Anda yang diaktifkan dengan lingkungan notebook.

  2. Buka tab Data Explorer>Notebooks>Galeri>Galeri publik.

  3. Terima tata tertib sebelum Anda menampilkan atau menerbitkan buku catatan di galeri. Tata tertib dicatat per pengguna, per tingkat langganan. Saat beralih ke langganan lain, Anda harus menerimanya lagi sebelum mengakses galeri. Untuk menerima tata tertib, pilih kotak centang dan Lanjutkan:

    Navigate to the notebooks public gallery and accept the code of conduct.

  4. Berikutnya Anda bisa menambahkan notebook tertentu ke tab favorit Anda atau mengunduhnya. Saat diunduh, notebook disalin ke ruang kerja notebook tempat Anda bisa menjalankan atau mengeditnya.

    Download a notebook from the gallery to your workspace.

Saat menyusun notebook Anda sendiri atau mengedit notebook yang sudah ada agar pas dengan skenario lain, Anda mungkin ingin menerbitkannya ke galeri. Setelah notebook diterbitkan ke galeri, pengguna lain dapat mengaksesnya. Anda dapat menjelajahi galeri sampel notebook untuk menampilkan notebook yang saat ini tersedia.

Gunakan langkah-langkah berikut untuk menerbitkan notebook:

  1. Masuk ke portal Microsoft Azure dan buka akun Azure Cosmos DB Anda yang diaktifkan dengan lingkungan notebook.

  2. Buka tab Data Explorer>Notebooks>Notebooks Saya.

  3. Masuk ke notebook yang ingin Anda terbitkan. Pilih tombol Simpan di bilah perintah, lalu pilih Terbitkan ke galeri:

    Choose a notebook to publish to the gallery.

    Anda juga dapat menemukan opsi Terbitkan ke galeri dengan memilih tombol ... di sebelah nama buku catatan:

    Another approach to choose a notebook to publish to the gallery.

  4. Isi formulir Terbitkan ke galeri dengan detail berikut ini:

    • Nama: Nama notebook Anda yang mudah diidentifikasi.
    • Deskripsi: Deskripsi singkat tentang apa yang dilakukan buku catatan Anda.
    • Tag: Tag bersifat opsional dan digunakan untuk memfilter hasil saat dicari oleh kata kunci.
    • Gambar sampul: Gambar yang digunakan di halaman sampul saat notebook diterbitkan. Anda dapat memilih salah satu opsi berikut ini:
    • Gambar kustom - Anda dapat mengunggah gambar dari komputer Anda. Pilih file gambar dengan rasio aspek 256x144.
    • URL - Berikan URL yang dapat diakses publik tempat gambar berada.
    • Ambil cuplikan layar - Cuplikan layar notebook terbuka milik Anda diambil dan diunggah ke pratinjau secara otomatis.
    • Gunakan output tampilan pertama - Output dari sel pertama yang memiliki output tampilan. Sel yang hanya menampilkan markdown/teks tidak dihitung sebagai output tampilan.

    Fill out the publish to gallery form.

    Catatan

    Jika Anda menggunakan opsi Terbitkan ke galeri dari tombol … di samping nama buku catatan, Anda tidak akan melihat opsi Gambar sampul. Itu karena notebook mungkin tidak terbuka dan Azure Cosmos DB tidak akan memiliki akses untuk mengambil cuplikan layar atau mengakses output tampilan pertama.

  5. Pastikan pratinjau terlihat bagus dan pilih Terbitkan. Ketika diterbitkan, notebook ini akan muncul di galeri publik notebook Azure Cosmos DB. Pastikan Anda telah menghapus data atau output sensitif sebelum penerbitan. Konten notebook dipindai untuk setiap pelanggaran kebijakan Microsoft sebelum diterbitkan. Proses ini biasanya membutuhkan waktu beberapa detik sampai selesai. Jika ditemukan pelanggaran, pesan ditampilkan di tab pemberitahuan. Notebook Anda tidak akan diterbitkan jika ditemukan pelanggaran, hapus teks yang dilanggar dan terbitkan lagi.

    Catatan

    Setelah notebook diterbitkan ke galeri publik, semua pengguna Azure Cosmos DB dapat melihatnya. Akses tidak terbatas pada per langganan, atau per tingkat organisasi.

  6. Setelah notebook diterbitkan ke galeri, Anda dapat melihatnya di dalam tab Pekerjaan saya yang diterbitkan. Anda juga dapat menghapus notebook yang telah Anda terbitkan dari galeri publik.

  7. Anda juga dapat melaporkan notebook yang melanggar tata tertib. Jika pelanggaran ditemukan, Cosmos DB menghapus notebook dari galeri secara otomatis. Jika notebook dihapus, pengguna dapat melihatnya di bawah tab Pekerjaan saya yang diterbitkan dengan catatan penghapusan. Untuk melaporkan notebook, buka tab Data Explorer>Notebooks>Galeri>Galeri publik. Buka notebook yang ingin dilaporkan, arahkan kursor ke tombol Bantuan di sudut kanan dan pilih Laporkan penyalahgunaan.

    Report a notebook that violates the code of conduct.

Langkah berikutnya