Mengkonfigurasi Layanan Data Oracle Rest () ORDS - Layanan Basis Data Relasional Amazon
Menyiapkan ORDS 21 dan lebih rendahMenyiapkan ORDS 22 dan lebih tinggi

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Mengkonfigurasi Layanan Data Oracle Rest () ORDS

Topik berikut mencantumkan opsi konfigurasi untuk ORDS 21 dan 22:

Menginstal dan mengkonfigurasi ORDS 21 dan lebih rendah

Anda sekarang siap untuk menginstal dan mengkonfigurasi Oracle Rest Data Services (ORDS) untuk digunakan dengan APEX Oracle. Untuk APEX versi 5.0 dan yang lebih baru, gunakan ORDS versi 19.1 hingga 21. Untuk mempelajari cara menginstal ORDS 22 dan lebih tinggi, lihatMenginstal dan mengkonfigurasi ORDS 22 dan lebih tinggi.

Instal listener di host terpisah seperti EC2 instans Amazon, server lokal di perusahaan Anda, atau komputer desktop Anda. Untuk contoh di bagian ini, kami berasumsi bahwa nama host Anda adalah myapexhost.example.com, dan bahwa host Anda menjalankan Linux.

Untuk menginstal dan mengkonfigurasi ORDS 21 dan lebih rendah untuk digunakan dengan Oracle APEX

  1. Pergi ke layanan REST data Oracle, dan periksa Readme. Pastikan Anda telah menginstal versi Java yang diperlukan.

  2. Buat direktori baru untuk ORDS instalasi Anda.

    mkdir /home/apexuser/ORDS
cd /home/apexuser/ORDS

  3. Unduh file ords.version.number.zip dari layanan REST data Oracle.

  4. Ekstrak file ke dalam direktori /home/apexuser/ORDS.

  5. Jika Anda menginstal ORDS dalam database multitenant, tambahkan baris berikut ke file: /home/apexuser/ORDS/params/ords_params.properties

    pdb.disable.lockdown=false

  6. Berikan pengguna master hak istimewa yang diperlukan untuk menginstalORDS.

    Setelah RDS APEX opsi Amazon diinstal, berikan pengguna master hak istimewa yang diperlukan untuk menginstal ORDS skema. Anda dapat melakukannya dengan menghubungkan ke basis data dan menjalankan perintah berikut. Ganti MASTER_USER dengan nama pengguna master dengan huruf besar.

    penting

    Jika Anda memasukkan nama pengguna, gunakan huruf besar kecuali Anda membuat pengguna dengan pengidentifikasi peka huruf besar/kecil. Misalnya, jika Anda menjalankan CREATE USER myuser atau CREATE USER MYUSER, kamus data akan menyimpan MYUSER. Namun, jika Anda menggunakan tanda kutip ganda di CREATE USER "MyUser", kamus data akan menyimpan MyUser. Untuk informasi selengkapnya, lihat Pemberian SELECT atau EXECUTE hak istimewa untuk objek SYS.

    exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_OBJECTS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_ROLE_PRIVS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_TAB_COLUMNS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_CONS_COLUMNS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_CONSTRAINTS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_OBJECTS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_PROCEDURES', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_TAB_COLUMNS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_TABLES', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_VIEWS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('WPIUTL', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_SESSION', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_UTILITY', 'MASTER_USER', 'EXECUTE', true);
    catatan

    Perintah ini berlaku untuk ORDS versi 19.1 dan yang lebih baru.

  7. Instal ORDS skema menggunakan file ords.war yang diunduh.

    java -jar ords.war install advanced

    Program ini meminta Anda untuk memberikan informasi berikut. Nilai default-nya ada dalam tanda kurung. Untuk informasi selengkapnya, lihat Pengantar layanan REST data Oracle di dokumentasi Oracle.

    • Masukkan lokasi untuk menyimpan data konfigurasi:

      Masuk /home/apexuser/ORDS. Ini adalah lokasi file ORDS konfigurasi.

    • Tentukan tipe koneksi basis data yang akan digunakan. Masukkan nomor untuk [1] Dasar [2] TNS [3] Kustom URL [1]:

      Pilih jenis koneksi yang diinginkan.

    • Masukkan nama server database [localhost]: DB_instance_endpoint

      Pilih default atau masukkan nilai yang benar.

    • Masukkan port pendengar database [1521]: DB_instance_port

      Pilih default atau masukkan nilai yang benar.

    • Masukkan 1 untuk menentukan nama layanan database, atau 2 untuk menentukan database SID [1]:

      Pilih 2 untuk menentukan databaseSID.

    • Basis data SID [xe]

      Pilih default atau masukkan nilai yang benar.

    • Masukkan 1 jika Anda ingin memverifikasi/menginstal skema Layanan REST Data Oracle atau 2 untuk melewati langkah ini [1]:

      Pilih 1. Langkah ini membuat pengguna proxy Oracle REST Data Services bernama ORDS _ PUBLIC _USER.

    • Masukkan kata sandi database untuk ORDS _ PUBLIC _USER:

      Masukkan kata sandi, lalu konfirmasi.

    • Perlu login dengan hak administrator untuk memverifikasi skema Layanan REST Data Oracle.

      Masukkan nama pengguna administrator: master_user

      Masukkan kata sandi database untuk master_user: master_user_password

      Konfirmasikan kata sandi: master_user_password

      catatan

      Tetapkan kata sandi selain penggugah (prompt) yang ditampilkan di sini sebagai praktik terbaik keamanan.

    • Masukkan tablespace default untuk ORDS _ METADATA [SYSAUX].

      Masukkan tablespace sementara untuk ORDS _ METADATA [TEMP].

      Masukkan tablespace default untuk ORDS _ PUBLIC _ USER [USERS].

      Masukkan tablespace sementara untuk ORDS _ PUBLIC _ USER [TEMP].

    • Masukkan 1 jika Anda ingin menggunakan SQL PL/Gateway atau 2 untuk melewati langkah ini. Jika Anda menggunakan Oracle Application Express atau bermigrasi dari mod_plsql, Anda harus memasukkan 1 [1].

      Pilih default.

    • Masukkan nama pengguna database SQL PL/Gateway [APEX_ PUBLIC _USER]

      Pilih default.

    • Masukkan kata sandi database untuk APEX _ PUBLIC _USER:

      Masukkan kata sandi, lalu konfirmasi.

    • Masukkan 1 untuk menentukan kata sandi bagi pengguna database Application Express RESTful Services (APEXAPEX_LISTENER, REST PUBLIC _ _ _USER) atau 2 untuk melewati langkah ini [1]:

      Pilih 2 untuk APEX 4.1.1.V1; pilih 1 untuk semua versi lainnya. APEX

    • [Tidak diperlukan untuk APEX 4.1.1.v1] Kata sandi basis data untuk _ APEX LISTENER

      Masukkan kata sandi (jika diperlukan), lalu konfirmasi.

    • [Tidak diperlukan untuk APEX 4.1.1.v1] Kata sandi basis data untuk _ _ _ APEX REST PUBLIC USER

      Masukkan kata sandi (jika diperlukan), lalu konfirmasi.

    • Masukkan nomor untuk memilih fitur yang akan diaktifkan:

      Masukkan 1 untuk mengaktifkan semua fitur: Web SQL Pengembang, REST DiaktifkanSQL, dan DatabaseAPI.

    • Masukkan 1 jika Anda ingin memulai dalam mode mandiri atau 2 untuk keluar [1]:

      Masukkan 1.

    • Masukkan lokasi sumber daya APEX statis:

      Jika Anda membuka ritsleting file APEX instalasi/home/apexuser, masukkan. /home/apexuser/apex/images Jika tidak, masukunzip_path/apex/images, di mana unzip_path adalah direktori tempat Anda membuka ritsleting file.

    • Masukkan 1 jika menggunakan HTTP atau 2 jika menggunakan HTTPS [1]:

      Jika Anda masuk1, tentukan HTTP port. Jika Anda masuk2, tentukan HTTPS port dan nama SSL host. HTTPSOpsi meminta Anda untuk menentukan bagaimana Anda akan memberikan sertifikat:

      • Memasukkan 1 untuk menggunakan sertifikat yang ditandatangani sendiri.

      • Memasukkan 2 untuk memberikan sertifikat Anda sendiri. Jika Anda masuk2, tentukan jalur untuk SSL sertifikat dan jalur untuk kunci pribadi SSL sertifikat.

  8. Tetapkan kata sandi untuk APEX admin pengguna. Untuk melakukan ini, gunakan SQL *Plus untuk terhubung ke instans DB Anda sebagai pengguna utama, dan kemudian jalankan perintah berikut.

    EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role;
grant APEX_ADMINISTRATOR_ROLE to master;
@/home/apexuser/apex/apxchpwd.sql

    Ganti master dengan nama pengguna master Anda. Ketika diminta oleh skrip apxchpwd.sql, masukkan kata sandi admin yang baru.

  9. Mulai ORDS pendengar. Jalankan kode berikut.

    java -jar ords.war

    Pertama kali Anda memulaiORDS, Anda diminta untuk menyediakan lokasi sumber daya APEX Statis. Folder gambar ini terletak di /apex/images direktori di direktori instalasi untukAPEX.

  10. Kembali ke jendela APEX administrasi di browser Anda dan pilih Administrasi. Selanjutnya, pilih Application Express Internal Administration. Saat Anda diminta untuk memberikan kredensial, masukkan informasi berikut ini:

    • Nama pengguna – admin

    • Kata sandi - kata sandi yang Anda tetapkan menggunakan skrip apxchpwd.sql

    Pilih Masuk, lalu tetapkan kata sandi baru untuk pengguna admin.

Pendengar Anda sekarang siap digunakan.

Menginstal dan mengkonfigurasi ORDS 22 dan lebih tinggi

Anda sekarang siap untuk menginstal dan mengkonfigurasi Oracle Rest Data Services (ORDS) untuk digunakan dengan APEX Oracle. Untuk contoh di bagian ini, kami berasumsi bahwa nama host terpisah Anda adalahmyapexhost.example.com, dan bahwa host Anda menjalankan Linux. Instruksi untuk ORDS 22 berbeda dari instruksi untuk rilis sebelumnya.

Untuk menginstal dan mengkonfigurasi ORDS 22 dan lebih tinggi untuk digunakan dengan Oracle APEX

  1. Buka layanan REST data Oracle, dan periksa Readme untuk ORDS versi yang Anda rencanakan untuk diunduh. Pastikan Anda telah menginstal versi Java yang diperlukan.

  2. Buat direktori baru untuk ORDS instalasi Anda.

    mkdir /home/apexuser/ORDS
cd /home/apexuser/ORDS

  3. Unduh file ords.version.number.zip atau ords-latest.zip dari layanan REST data Oracle.

  4. Ekstrak file ke dalam direktori /home/apexuser/ORDS.

  5. Berikan pengguna master hak istimewa yang diperlukan untuk menginstalORDS.

    Setelah RDS APEX opsi Amazon diinstal, berikan pengguna master hak istimewa yang diperlukan untuk menginstal ORDS skema. Anda dapat melakukan ini dengan masuk ke database dan menjalankan perintah berikut. Ganti MASTER_USER dengan nama pengguna master dengan huruf besar.

    penting

    Jika Anda memasukkan nama pengguna, gunakan huruf besar kecuali Anda membuat pengguna dengan pengidentifikasi peka huruf besar/kecil. Misalnya, jika Anda menjalankan CREATE USER myuser atau CREATE USER MYUSER, kamus data akan menyimpan MYUSER. Namun, jika Anda menggunakan tanda kutip ganda di CREATE USER "MyUser", kamus data akan menyimpan MyUser. Untuk informasi selengkapnya, lihat Pemberian SELECT atau EXECUTE hak istimewa untuk objek SYS.

    exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_OBJECTS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_ROLE_PRIVS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_TAB_COLUMNS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_CONS_COLUMNS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_CONSTRAINTS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_OBJECTS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_PROCEDURES', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_TAB_COLUMNS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_TABLES', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('USER_VIEWS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('WPIUTL', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_SESSION', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_UTILITY', 'MASTER_USER', 'EXECUTE', true);

exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_LOB', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_ASSERT', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_OUTPUT', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_SCHEDULER', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('HTP', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('OWA', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('WPG_DOCLOAD', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_CRYPTO', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_METADATA', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_SQL', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('UTL_SMTP', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_NETWORK_ACL_ADMIN', 'MASTER_USER', 'EXECUTE', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('SESSION_PRIVS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_USERS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_NETWORK_ACL_PRIVILEGES', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_NETWORK_ACLS', 'MASTER_USER', 'SELECT', true);
exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_REGISTRY', 'MASTER_USER', 'SELECT', true);
    catatan

    Perintah sebelumnya berlaku untuk ORDS 22 dan yang lebih baru.

  6. Instal ORDS skema menggunakan ords skrip yang diunduh. Tentukan direktori untuk berisi file konfigurasi dan file log. Oracle Corporation merekomendasikan untuk tidak menempatkan direktori ini di dalam direktori yang berisi perangkat lunak ORDS produk.

    mkdir -p /home/apexuser/ords_config /home/apexuser/ords_logs

/home/apexuser/ORDS/bin/ords \
  --config /home/apexuser/ords_config \
  install --interactive --log-folder /home/apexuser/ords_logs

    Untuk instance DB yang menjalankan arsitektur database container (CDB), gunakan ORDS 23.2 dan yang lebih tinggi dan teruskan --pdb-skip-disable-lockdown argumen saat menginstal. ORDS

    /home/apexuser/ORDS/bin/ords \
  --config /home/apexuser/ords_config \
  install --interactive --log-folder /home/apexuser/ords_logs --pdb-skip-disable-lockdown

    Program ini meminta Anda untuk memberikan informasi berikut. Nilai default-nya ada dalam tanda kurung. Untuk informasi selengkapnya, lihat Pengantar layanan REST data Oracle di dokumentasi Oracle.

    • Choose the type of installation:

      Pilih 2 untuk menginstal ORDS skema dalam database dan membuat kumpulan koneksi database dalam file ORDS konfigurasi lokal.

    • Specify the database connection type to use. Enter number for [1] Basic [2] TNS [3] Custom URL:

      Pilih tipe koneksi yang diinginkan. Contoh ini mengasumsikan bahwa Anda memilih1.

    • Enter the name of the database server [localhost]: DB_instance_endpoint

      Pilih default atau masukkan nilai yang benar.

    • Enter the database listener port [1521]: DB_instance_port

      Pilih default 1521 atau masukkan nilai yang benar.

    • Enter the database service name [orcl]:

      Masukkan nama database yang digunakan oleh instans DB Oracle AndaRDS.

    • Provide database user name with administrator privileges

      Masukkan nama pengguna master untuk instans Oracle DB AndaRDS.

    • Enter the database password for [username]:

      Masukkan kata sandi pengguna utama untuk instans Oracle DB AndaRDS.

    • Enter the default tablespace for ORDS_METADATA and ORDS_PUBLIC_USER [SYSAUX]:

    • Enter the temporary tablespace for ORDS_METADATA [TEMP]. Enter the default tablespace for ORDS_PUBLIC_USER [USERS]. Enter the temporary tablespace for ORDS_PUBLIC_USER [TEMP].

    • Enter a number to select additional feature(s) to enable [1]:

    • Enter a number to configure and start ORDS in standalone mode [1]:

      Pilih 2 untuk ORDS langsung melewatkan memulai dalam mode mandiri.

    • Enter a number to select the protocol [1] HTTP

    • Enter the HTTP port [8080]:

    • Enter the APEX static resources location:

      Masukkan jalur ke file APEX instalasi (/home/apexuser/apex/images).

  7. Tetapkan kata sandi untuk APEX admin pengguna. Untuk melakukan ini, gunakan SQL *Plus untuk terhubung ke instans DB Anda sebagai pengguna utama, dan kemudian jalankan perintah berikut.

    EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role;
grant APEX_ADMINISTRATOR_ROLE to master;
@/home/apexuser/apex/apxchpwd.sql

    Ganti master dengan nama pengguna master Anda. Ketika diminta oleh skrip apxchpwd.sql, masukkan kata sandi admin yang baru.

  8. Jalankan ORDS dalam mode mandiri menggunakan ords skrip dengan serve perintah. Untuk penyebaran produksi, pertimbangkan untuk menggunakan server aplikasi Java EE yang didukung seperti Apache Tomcat atau Oracle Server. WebLogic Untuk informasi selengkapnya, lihat Menyebarkan dan Memantau Layanan REST Data Oracle dalam dokumentasi Oracle Database.

    /home/apexuser/ORDS/bin/ords \
  --config /home/apexuser/ords_config serve \
  --port 8193 \
  --apex-images /home/apexuser/apex/images

    Jika ORDS sedang berjalan tetapi tidak dapat mengakses APEX instalasi, Anda mungkin melihat kesalahan berikut, terutama pada CDB non-instance. 

    The procedure named apex_admin could not be accessed, it may not be declared, or the user executing this request may not have been granted execute privilege on the procedure, or a function specified by security.requestValidationFunction configuration property has prevented access.

    Untuk memperbaiki kesalahan ini, ubah fungsi validasi permintaan yang digunakan ORDS dengan menjalankan ords skrip dengan config perintah. Secara default, ORDS menggunakan ords_util.authorize_plsql_gateway prosedur, yang hanya didukung pada CDB instance. Untuk CDB non-instance, Anda dapat mengubah prosedur ini ke wwv_flow_epg_include_modules.authorize paket. Lihat dokumentasi Oracle Database dan Oracle Support untuk praktik terbaik dalam mengonfigurasi fungsi validasi permintaan yang tepat untuk kasus penggunaan Anda.

  9. Kembali ke jendela APEX administrasi di browser Anda dan pilih Administrasi. Selanjutnya, pilih Application Express Internal Administration. Saat Anda diminta untuk memberikan kredensial, masukkan informasi berikut ini:

    • Nama pengguna – admin

    • Kata sandi - kata sandi yang Anda tetapkan menggunakan skrip apxchpwd.sql

    Pilih Masuk, lalu tetapkan kata sandi baru untuk pengguna admin.

Pendengar Anda sekarang siap digunakan.