All Products
Search
Document Center

Realtime Compute for Apache Flink:Ekstensi VS Code untuk pengembangan lokal

Last Updated:Aug 20, 2026

Ekstensi Realtime Compute for Apache Flink VS Code menyederhanakan proses pengembangan pekerjaan Flink secara lokal. Ekstensi ini memungkinkan Anda mengembangkan, menerapkan, dan mengelola pekerjaan SQL, JAR, dan Python, serta menyinkronkan konfigurasi pekerjaan dari cloud. Topik ini menjelaskan cara menggunakan ekstensi tersebut.

Prasyarat

Batasan

  • Konfigurasi log tidak didukung.

  • Ekstensi ini tidak mendukung penarikan pekerjaan yang sudah ada dari cloud.

Instal dan konfigurasikan ekstensi

  1. Unduh dan instal ekstensi.

    • Metode 1: Buka VS Code Marketplace, lalu klik Install.

    • Metode 2:

      1. Buka VS Code dan klik EXTENSIONS di panel navigasi sebelah kiri.

      2. Di bilah pencarian, cari ekstensi Flink Realtime Compute Studio.

      3. Klik Install.

  2. Pada bilah menu atas, klik File > Open Folder, lalu pilih folder lokal.

  3. Konfigurasikan Informasi AccessKey Anda.

    Ruang kerja saat ini

    1. Di panel navigasi sebelah kiri, klik ikon image. Di bagian Configure AK&SK, klik Configure in a .vvprc file. Ekstensi secara otomatis membuat file dengan ekstensi .vvprc.

    2. Tambahkan konfigurasi berikut ke dalam file tersebut:

      {
        "accessKey": "xxx",
        "secretKey": "xxx",
        "namespace": "xxx",
        "workspace": "xxx",
        "regionId" : "xxx"
      }

      Parameter

      Deskripsi

      Catatan

      accessKey

      ID AccessKey akun Alibaba Cloud Anda.

      Untuk informasi selengkapnya, lihat Bagaimana cara memperoleh ID AccessKey dan Secret AccessKey?

      secretKey

      Secret AccessKey akun Alibaba Cloud Anda.

      namespace

      Nama namespace Flink.

      Untuk informasi selengkapnya, lihat Melihat dan menghapus namespace.

      workspace

      ID ruang kerja Flink.

      Untuk informasi selengkapnya, lihat Bagaimana cara melihat ID ruang kerja dan informasi lainnya?.

      regionId

      ID wilayah.

      Temukan ID wilayah di Endpoints.

    Global

    1. Di panel navigasi sebelah kiri, klik ikon image.

    2. Di bagian Configure AK&SK, klik Configure in global user settings. VS Code membuka halaman pengaturan global.

      Cari flinkStudio dan atur bidang-bidang berikut: Flink Studio: Access Key, Flink Studio: Secret Key, Flink Studio: Namespace, Flink Studio: Region ID (default: cn-hangzhou), dan Flink Studio: Workspace.

    3. Jika diperlukan, pilih User atau Workspace untuk konfigurasi.

      Catatan

      Kami menyarankan mengatur cakupan ke User, yang menerapkan konfigurasi ke semua proyek. Cakupan Workspace hanya menerapkan konfigurasi ke ruang kerja saat ini.

      Parameter

      Deskripsi

      Catatan

      Access Key

      ID AccessKey akun Alibaba Cloud Anda.

      Untuk informasi selengkapnya, lihat Bagaimana cara memperoleh ID AccessKey dan Secret AccessKey?

      Secret Key

      Secret AccessKey akun Alibaba Cloud Anda.

      Untuk informasi selengkapnya, lihat Bagaimana cara memperoleh ID AccessKey dan Secret AccessKey?

      Namespace

      Nama namespace Flink.

      Untuk informasi selengkapnya, lihat Melihat dan menghapus namespace.

      Workspace

      ID ruang kerja Flink.

      Untuk informasi selengkapnya, lihat Bagaimana cara melihat ID ruang kerja dan informasi lainnya?.

      Region ID

      ID wilayah.

      Temukan ID wilayah di Endpoints.

    Catatan

    Prioritas konfigurasi: Folder saat ini > Folder induk > Global.

    Setelah Anda menerapkan konfigurasi, nama namespace akan muncul di bilah status di bagian bawah editor.

  4. (Opsional) Anda dapat menginstal ekstensi berikut untuk pengalaman pengembangan yang lebih baik.

    • Flink SQL: Instal ekstensi Flink SQL Language Features. Ekstensi ini menyediakan layanan bahasa untuk Flink SQL dan mendukung sintaks Flink SQL lengkap.

    • Konfigurasi Flink: Kami menyarankan menginstal ekstensi YAML VS Code, yang menyediakan pelengkapan otomatis untuk konfigurasi Flink.

Prosedur

Langkah 1: Buat pekerjaan

  • Metode 1: Di panel navigasi sebelah kiri, klik ikon image. Di bagian QUICK START, klik Create a new deployment. Masukkan nama di bagian atas, lalu tekan Enter untuk membuat file dengan ekstensi .vvp. Ekstensi menghasilkan pekerjaan dengan bidang default.

  • Metode 2: Buat file baru dengan ekstensi .vvp langsung di explorer file. Ekstensi mengisi file tersebut dengan konfigurasi pekerjaan default.

Langkah 2: Konfigurasikan pekerjaan

Anda dapat mengonfigurasi parameter langsung di formulir UI.

Jika Anda terbiasa dengan konfigurasi pekerjaan, klik Raw File di pojok kiri atas untuk mengonfigurasi pekerjaan di file sumber. Mengklik nama parameter di formulir UI akan membawa Anda ke definisinya di file sumber.

{
  "name": "test",
  "artifact": {
    "kind": "SQLSCRIPT",
    "sqlArtifact": {
      "additionalDependencies": [],
      "sqlScript": ""
    }
  },
  "deploymentTarget": {
    "mode": "PER_JOB",
    "name": "default-queue"
  },
  ...
}
  • Basic: Konfigurasikan parameter dasar.

    Pekerjaan SQL

    Parameter

    Deskripsi

    Deployment Name

    Nama deployment.

    Execution Mode

    Mode penyebaran. Gunakan STREAM untuk mode streaming atau BATCH untuk mode batch.

    Engine Version

    Untuk informasi selengkapnya tentang versi engine, lihat Versi engine. Kami menyarankan Anda menggunakan versi terbaru yang direkomendasikan.

    Deployment Target

    Antrian sumber daya untuk deployment. Untuk informasi selengkapnya, lihat Mengelola antrian sumber daya.

    Deployment Type

    Pilih SQL.

    SQL Script

    Klik Open in external editor untuk membuka editor lokal. Tulis kode DDL dan DML Anda.

    Catatan

    File yang dibuka di editor adalah file virtual yang tidak disimpan di sistem file aktual. Oleh karena itu, jika Anda membuka kembali VS Code, tab editor untuk file virtual yang belum ditutup akan menampilkan pesan error The editor could not be opened because the file was not found. Untuk membuka file tersebut, klik Open in external editor lagi.

    Additional Dependencies

    Dependensi tambahan yang diperlukan oleh pekerjaan. Masukkan URI file dependensi target.

    Description

    Opsional. Masukkan deskripsi untuk pekerjaan.

    Pekerjaan JAR

    Untuk informasi selengkapnya tentang konfigurasi parameter, lihat Menyebarkan pekerjaan JAR.

    Parameter

    Deskripsi

    Deployment Name

    Nama deployment.

    Execution Mode

    Mode penyebaran. Gunakan STREAM untuk mode streaming atau BATCH untuk mode batch.

    Engine Version

    Versi engine. Untuk informasi selengkapnya, lihat Versi engine. Kami menyarankan Anda menggunakan versi terbaru yang direkomendasikan.

    Deployment Target

    Antrian sumber daya untuk deployment. Untuk informasi selengkapnya, lihat Mengelola antrian sumber daya.

    Deployment Type

    Jenis pekerjaan yang akan diterapkan. Pilih JAR.

    JAR URI

    Jalur OSS atau URL paket JAR.

    Pastikan Anda telah mengunggah file dependensi terkait ke Artifacts di Konsol Pengembangan atau ke Bucket OSS yang terikat dan telah memperoleh jalur yang sesuai.

    Entry Point Class

    Kelas utama yang akan dieksekusi. Wajib diisi jika manifes JAR tidak menentukan kelas utama.

    Entry Point Main Arguments

    Masukkan argumen input yang akan diteruskan ke metode main.

    Additional Dependencies

    Masukkan jalur OSS atau URL file dependensi tambahan. Saat ini, hanya URL yang diakhiri dengan nama file yang didukung.

    Pastikan Anda telah mengunggah file dependensi terkait ke Artifacts di Konsol Pengembangan atau ke Bucket OSS yang terikat dan telah memperoleh jalur yang sesuai.

    Description

    Opsional. Masukkan deskripsi untuk pekerjaan.

    Pekerjaan Python

    Untuk informasi selengkapnya tentang konfigurasi parameter, lihat Menyebarkan pekerjaan Python.

    Parameter

    Deskripsi

    Deployment Name

    Nama deployment.

    Execution Mode

    Mode penyebaran. Gunakan STREAM untuk mode streaming atau BATCH untuk mode batch.

    Engine Version

    Versi engine. Untuk informasi selengkapnya, lihat Versi engine. Kami menyarankan Anda menggunakan versi terbaru yang direkomendasikan.

    Deployment Target

    Antrian sumber daya untuk deployment. Untuk informasi selengkapnya, lihat Mengelola antrian sumber daya.

    Deployment Type

    Jenis pekerjaan yang akan diterapkan. Pilih Python.

    Python URI

    URI file pekerjaan Python, yang dapat berupa file .py atau .zip.

    Entry Module

    Modul entri yang akan dieksekusi.

    • Tidak wajib untuk file .py.

    • Wajib untuk file .zip.

    Entry Point Main Arguments

    Masukkan argumen input yang akan diteruskan ke metode main.

    Python Libraries

    Paket Python pihak ketiga. Paket-paket ini ditambahkan ke PYTHONPATH proses worker Python, sehingga dapat diakses langsung dalam fungsi user-defined Python. Untuk informasi tentang cara menggunakan paket Python pihak ketiga, lihat Menggunakan paket Python pihak ketiga.

    Python Archives

    File arsip. Untuk informasi selengkapnya, lihat Menggunakan lingkungan virtual Python kustom dan Menggunakan file data.

    Additional Dependencies

    Masukkan jalur OSS atau URL file dependensi tambahan.

    Pastikan Anda telah mengunggah file dependensi terkait ke Artifacts di Konsol Pengembangan atau ke Bucket OSS yang terikat dan telah memperoleh jalur yang sesuai.

    Description

    Opsional. Masukkan deskripsi untuk pekerjaan.

  • Resources: Untuk informasi selengkapnya tentang parameter sumber daya pekerjaan, lihat Mengonfigurasi sumber daya pekerjaan.

  • Parameters: Untuk informasi selengkapnya tentang parameter waktu proses pekerjaan, lihat Mengonfigurasi parameter waktu proses.

Langkah 3: Terapkan pekerjaan

Setelah selesai mengembangkan atau mengonfigurasi pekerjaan, klik Create di bagian bawah untuk menerapkan pekerjaan baru, atau klik Update untuk memperbarui dan menerapkan pekerjaan lokal yang sudah ada.

Untuk pekerjaan SQL, ekstensi memvalidasi skrip SQL, paket sumber daya, dan konfigurasi lainnya, lalu mengeluarkan hasil validasi.

Langkah 4: Jalankan pekerjaan

Untuk pekerjaan yang telah diterapkan, status terbaru ditampilkan di pojok kanan atas. Anda dapat mengklik Start dan memilih mode startup. Untuk informasi selengkapnya tentang mode startup, lihat Menjalankan pekerjaan.

Langkah 5: O&M pekerjaan

Setelah pekerjaan diterapkan dan berjalan, status RUNNING berwarna hijau muncul di bilah aksi di bagian atas editor. Area Basic menampilkan informasi deployment utama dalam bentuk tabel, termasuk Deployment ID, Deployment Name, Execution Mode, Engine Version (misalnya, vvr-8.0.7-flink-1.17), Deployment Target, dan Deployment Type.

  • Open Online: Klik Open Online untuk membuka halaman O&M pekerjaan di Konsol Pengembangan, tempat Anda dapat melihat status berjalan dan melakukan operasi O&M.

  • Synchronize: Menarik konfigurasi pekerjaan dari cloud. Mengklik Synchronize membuka pratinjau konfigurasi online. Catatan: Pratinjau tidak mencakup perubahan draft yang dibuat pada pekerjaan SQL di konsol. Klik Accept untuk menimpa file lokal Anda dengan konfigurasi online.

  • Cancel: Menghentikan pekerjaan yang sedang berjalan.

Dokumentasi terkait