PolarDB：PolarPlus

Unduh klien PolarPlus

PolarPlus menyediakan paket klien tanpa instalasi. Anda dapat menggunakannya di Linux setelah mengunduh dan mengekstrak paket tersebut. Kode berikut menunjukkan struktur direktori PolarPlus yang telah diekstrak. File polarplus dapat dieksekusi. Jika Anda menambahkan jalur direktori polarplus_release/ ke variabel sistem PATH, Anda dapat menjalankan perintah polarplus.

polarplus_release
├── polarplus -> ./polarplus.sh
├── polarplus.sh
├── polarplus.jar
├── login.sql
├── etc
│   └── sysconfig
├── help
└── lib

Menggunakan PolarPlus

Ikhtisar

PolarPlus menyediakan CLI untuk PolarDB. Ini mendukung pernyataan SQL, perintah PolarPlus, blok anonim PL/SQL, fungsi, dan prosedur tersimpan. PolarPlus memungkinkan Anda melakukan operasi berikut:

• Mengecek objek database tertentu.

• Menjalankan prosedur tersimpan.

• Memformat keluaran dari pernyataan SQL.

• Menjalankan skrip pemrosesan batch.

• Menjalankan perintah OS.

• Mencatat keluaran.

Kompatibilitas dengan Oracle

PolarPlus disesuaikan untuk PolarDB dan mendukung fitur umum dari alat SQL*Plus Oracle.

Konfigurasikan PolarPlus

1. Jalankan perintah wget untuk mengunduh paket klien PolarPlus dari tautan yang ditentukan di bagian "Unduh Klien PolarPlus" topik ini. Ekstrak paket klien.

2. Buka file polarplus.sh.

3. Ubah baris export base="{pwd}/polarplus": Ganti {pwd} dengan jalur absolut file polarplus.

4. Di server tempat Anda ingin terhubung ke database PolarDB, jalankan perintah berikut untuk memulai PolarPlus:

   polarplus [ -S[ILENT ] ] [ login | /NOLOG ] [ @scriptfile[.ext ] ]

   Parameter	Deskripsi
   -S[ILENT ]	Jika Anda mengonfigurasi parameter ini, tidak ada banner logon atau pesan terkait logon yang muncul saat Anda menggunakan PolarPlus untuk terhubung ke database.
   login	Informasi logon yang digunakan untuk terhubung ke server database dan database. Nilai parameter ini harus ditentukan dalam format berikut: username[/password][@{connectstring | variable } ] Untuk informasi lebih lanjut, lihat tabel "Parameter logon" dalam topik ini. Parameter variabel adalah variabel yang didefinisikan dalam file login.sql. File login.sql berisi string koneksi database.
   /NOLOG	Jika Anda menentukan /NOLOG, tidak ada koneksi ke database yang dibuat saat Anda memulai PolarPlus. Jika Anda ingin terhubung ke database untuk mengeksekusi pernyataan SQL atau menjalankan perintah PolarPlus, jangan tentukan opsi ini. Catatan Jika Anda menentukan opsi ini saat memulai PolarPlus dan ingin terhubung ke database, jalankan perintah CONNECT.
   scriptfile[.ext ]	Parameter scriptfile menentukan nama file yang disimpan di direktori kerja saat ini. File ini berisi pernyataan SQL yang secara otomatis dieksekusi dan perintah PolarPlus yang secara otomatis dijalankan setelah Anda memulai PolarPlus. menentukan ekstensi file. Jika ekstensi file dari file skrip adalah .sql, Anda dapat menghilangkan ekstensi file saat menentukan file skrip. Saat membuat file skrip, beri nama file dalam format <Nama file>.<Ekstensi file>. Jika tidak, PolarPlus tidak dapat mengakses file. Catatan Untuk file yang tidak mengandung akhiran ekstensi file dalam nama file, PolarPlus memproses file tersebut sebagai file .sql.

   Tabel 1. Parameter Logon

   Parameter	Deskripsi
   username	Nama akun database yang digunakan untuk terhubung ke database.
   password	Kata sandi akun database yang digunakan untuk terhubung ke database.
   connectstring	String koneksi database. String koneksi harus ditentukan dalam format berikut: host[:port][/dbname][?ssl={true | false}] Parameter host menentukan nama host atau alamat IP server database. Catatan Jika parameter connectstring, variable, atau /NOLOG tidak dikonfigurasi, host default adalah host lokal. Jika Anda menggunakan alamat Internet Protocol versi 6 (IPv6) untuk terhubung ke database, Anda harus meletakkan alamat IP dalam tanda kurung ([]). Contoh berikut menunjukkan cara menggunakan alamat IPv6 untuk terhubung ke database: polarplus polardb/password@[fe80::20c:29ff:fe7c:78b2]:5444/polardb Parameter port menentukan port yang digunakan oleh server database untuk menerima permintaan koneksi. Catatan Jika Anda mengosongkan parameter ini, port default 5444 akan digunakan. Parameter dbname menentukan nama database yang ingin Anda hubungkan. Catatan Jika Anda mengosongkan parameter ini, nilai default polardb akan digunakan. Jika Anda ingin membuat koneksi SSL, Anda harus menentukan ?ssl = true dan host:port dalam string koneksi. Jika tidak, koneksi SSL tidak dapat dibuat.

   Contoh berikut menunjukkan cara menggunakan PolarPlus untuk terhubung ke database PolarDB:

   polarplus  polardb/password@pc-bp1zxxxxxxxxxxx.o.polardb.rds.aliyuncs.com:1521/polardb

   Catatan

   PolarPlus digunakan untuk terhubung hanya ke kluster PolarDB for PostgreSQL (Kompatibel dengan Oracle) 1.0. Untuk terhubung ke kluster PolarDB for PostgreSQL (Kompatibel dengan Oracle) 2.0, Anda harus mengunduh PolarPlus2. Struktur direktori dan penggunaan PolarPlus2 serupa dengan PolarPlus. Anda hanya perlu mengganti polarplus di direktori dan perintah dengan polarplus2.