Konektor Amazon Athena SAP HANA

Prasyarat

• Menyebarkan konektor ke Anda Akun AWS menggunakan konsol Athena atau. AWS Serverless Application Repository Untuk informasi selengkapnya, lihat Menyebarkan konektor sumber data atau MenggunakanAWS Serverless Application Repositoryuntuk menyebarkan konektor sumber data.

Batasan

• Menulis operasi DDL tidak didukung.

• Dalam pengaturan multiplexer, bucket tumpahan dan awalan dibagikan di semua instance database.

• Batas Lambda yang relevan. Untuk informasi selengkapnya, lihat Kuota Lambda dalam Panduan Pengembang AWS Lambda .

• Dalam SAP HANA, nama objek dikonversi ke huruf besar ketika mereka disimpan dalam database SAP HANA. Namun, karena nama dalam tanda kutip peka huruf besar/kecil, dimungkinkan untuk dua tabel memiliki nama yang sama dalam huruf kecil dan huruf besar (misalnya, EMPLOYEE danemployee).

  Di Athena Federated Query, nama tabel skema disediakan untuk fungsi Lambda dalam huruf kecil. Untuk mengatasi masalah ini, Anda dapat memberikan petunjuk @schemaCase kueri untuk mengambil data dari tabel yang memiliki nama peka huruf besar/kecil. Berikut ini adalah dua contoh query dengan petunjuk query.

  SELECT * 
  FROM "lambda:saphanaconnector".SYSTEM."MY_TABLE@schemaCase=upper&tableCase=upper"     

  SELECT * 
  FROM "lambda:saphanaconnector".SYSTEM."MY_TABLE@schemaCase=upper&tableCase=lower"     

Ketentuan

Istilah-istilah berikut berhubungan dengan konektor SAP HANA.

• Instans database — Instance apa pun dari database yang digunakan di tempat, di Amazon EC2, atau di Amazon RDS.

• Handler - Handler Lambda yang mengakses instance database Anda. Handler bisa untuk metadata atau untuk catatan data.

• Metadata handler — Penangan Lambda yang mengambil metadata dari instance database Anda.

• Record handler - Handler Lambda yang mengambil catatan data dari instance database Anda.

• Composite handler — Handler Lambda yang mengambil data metadata dan data dari instance database Anda.

• Properti atau parameter - Properti database yang digunakan oleh penangan untuk mengekstrak informasi database. Anda mengonfigurasi properti ini sebagai variabel lingkungan Lambda.

• Connection String — Sebuah string teks yang digunakan untuk membuat koneksi ke instance database.

• Katalog —AWS Glue Non-katalog yang terdaftar di Athena yang merupakan awalan yang diperlukan untuk properti. connection_string

• Multiplexing handler - Handler Lambda yang dapat menerima dan menggunakan beberapa koneksi database.

Parameter

Gunakan variabel lingkungan Lambda di bagian ini untuk mengkonfigurasi konektor SAP HANA.

String koneksi

Gunakan string koneksi JDBC dalam format berikut untuk terhubung ke instance database.

saphana://${jdbc_connection_string}

Menggunakan handler multiplexing

Anda dapat menggunakan multiplexer untuk terhubung ke beberapa instance database dengan satu fungsi Lambda. Permintaan dirutekan dengan nama katalog. Gunakan kelas berikut di Lambda.

Handler	Kelas
Handler komposit	SaphanaMuxCompositeHandler
Penangan metadata	SaphanaMuxMetadataHandler
Rekam handler	SaphanaMuxRecordHandler

Parameter handler multiplexing

Parameter	Deskripsi
$catalog_connection_string	Wajib. Sebuah string koneksi instance database. Awalan variabel lingkungan dengan nama katalog yang digunakan di Athena. Misalnya, jika katalog terdaftar di Athena adalahmysaphanacatalog, maka nama variabel lingkungan adalah. mysaphanacatalog_connection_string
default	Wajib. String koneksi default. String ini digunakan ketika katalog lambda:${ }AWS_LAMBDA_FUNCTION_NAME.

Contoh properti berikut adalah untuk fungsi Saphana MUX Lambda yang mendukung dua instance database: saphana1 (default), dan. saphana2

Properti	Nilai
default	saphana://jdbc:sap://saphana1.host:port/?${Test/RDS/ Saphana1}
saphana_catalog1_connection_string	saphana://jdbc:sap://saphana1.host:port/?${Test/RDS/ Saphana1}
saphana_catalog2_connection_string	saphana://jdbc:sap://saphana2.host:port/?user=sample2&password=sample2

Memberikan kredensi

Untuk memberikan nama pengguna dan kata sandi untuk database Anda dalam string koneksi JDBC Anda, Anda dapat menggunakan properti string koneksi atau. AWS Secrets Manager

• Connection String - Nama pengguna dan kata sandi dapat ditentukan sebagai properti dalam string koneksi JDBC.

  penting

  Sebagai praktik keamanan terbaik, jangan gunakan kredensyal hardcode dalam variabel lingkungan atau string koneksi Anda. Untuk informasi tentang memindahkan rahasia hardcode Anda AWS Secrets Manager, lihat Memindahkan rahasia hardcode ke AWS Secrets Manager dalam Panduan Pengguna.AWS Secrets Manager

• AWS Secrets Manager— Untuk menggunakan fitur Query Federasi Athena dengan, VPC AWS Secrets Manager yang terhubung ke fungsi Lambda Anda harus memiliki akses internet atau titik akhir VPC untuk terhubung ke Secrets Manager.

  Anda dapat memasukkan nama rahasia ke AWS Secrets Manager dalam string koneksi JDBC Anda. Konektor menggantikan nama rahasia dengan password nilai username dan dari Secrets Manager.

  Untuk instans database Amazon RDS, dukungan ini terintegrasi erat. Jika Anda menggunakan Amazon RDS, kami sangat menyarankan penggunaan AWS Secrets Manager dan rotasi kredensyal. Jika database Anda tidak menggunakan Amazon RDS, simpan kredensialnya sebagai JSON dalam format berikut:

  {"username": "${username}", "password": "${password}"}

Contoh string koneksi dengan nama rahasia

String berikut memiliki nama rahasia${Test/RDS/Saphana1}.

saphana://jdbc:sap://saphana1.host:port/?${Test/RDS/Saphana1}&...

Konektor menggunakan nama rahasia untuk mengambil rahasia dan memberikan nama pengguna dan kata sandi, seperti pada contoh berikut.

saphana://jdbc:sap://saphana1.host:port/?user=sample2&password=sample2&...

Saat ini, konektor SAP HANA mengenali properti user dan password JDBC.

Menggunakan handler koneksi tunggal

Anda dapat menggunakan metadata koneksi tunggal berikut dan penangan rekaman untuk terhubung ke satu instance SAP HANA.

Jenis handler	Kelas
Handler komposit	SaphanaCompositeHandler
Penangan metadata	SaphanaMetadataHandler
Rekam handler	SaphanaRecordHandler

Parameter handler koneksi tunggal

Parameter	Deskripsi
default	Wajib. String koneksi default.

Penangan koneksi tunggal mendukung satu instance database dan harus menyediakan parameter string default koneksi. Semua string koneksi lainnya diabaikan.

Properti contoh berikut adalah untuk satu instance SAP HANA yang didukung oleh fungsi Lambda.

Properti	Nilai
default	saphana://jdbc:sap://saphana1.host:port/?secret=Test/RDS/Saphana1

Parameter tumpahan

Lambda SDK dapat menumpahkan data ke Amazon S3. Semua instance database yang diakses oleh fungsi Lambda yang sama tumpah ke lokasi yang sama.

Parameter	Deskripsi
spill_bucket	Wajib. Nama ember tumpahan.
spill_prefix	Wajib. Tumpahkan key prefix bucket.
spill_put_request_headers	(Opsional) Peta header permintaan dan nilai yang disandikan JSON untuk permintaan Amazon S3 yang digunakan untuk menumpahkan (misalnya,). putObject {"x-amz-server-side-encryption" : "AES256"} Untuk kemungkinan header lainnya, lihat PutObjectdi Referensi API Amazon Simple Storage Service.

Dukungan tipe data

Tabel berikut menunjukkan tipe data yang sesuai untuk JDBC dan Apache Arrow.

JDBC	Panah
Boolean	Bit
Bilangan Bulat	Mungil
Pendek	Orang kecil
Bilangan Bulat	Int
Long	Bigint
float	Mengapung4
Ganda	Mengapung8
Tanggal	DateDay
Stempel Waktu	DateMilli
String	Varchar
Byte	Varbiner
BigDecimal	Decimal
ARRAY	Daftar

Konversi jenis data

Selain konversi JDBC ke Arrow, konektor melakukan konversi tertentu lainnya untuk membuat sumber SAP HANA dan tipe data Athena kompatibel. Konversi ini membantu memastikan bahwa kueri berhasil dieksekusi. Tabel berikut menunjukkan konversi ini.

Tipe data sumber (SAP HANA)	Tipe data yang dikonversi (Athena)
DECIMAL	BIGINT
INTEGER	INT
DATE	TANGGAL
TIMESTAMP	DATEMILLI

Semua tipe data lain yang tidak didukung dikonversi keVARCHAR.

Partisi dan split

Partisi diwakili oleh kolom partisi tunggal tipeInteger. Kolom berisi nama partisi dari partisi yang didefinisikan pada tabel SAP HANA. Untuk tabel yang tidak memiliki nama partisi, * dikembalikan, yang setara dengan satu partisi. Partisi setara dengan split.

Nama	Tipe	Deskripsi
PART_ID	Bilangan Bulat	Dinamakan partisi di SAP HANA.

Kinerja

SAP HANA mendukung partisi asli. Konektor Athena SAP HANA dapat mengambil data dari partisi ini secara paralel. Jika Anda ingin menanyakan kumpulan data yang sangat besar dengan distribusi partisi yang seragam, partisi asli sangat disarankan. Memilih subset kolom secara signifikan mempercepat runtime kueri dan mengurangi data yang dipindai. Konektor menunjukkan pelambatan yang signifikan, dan terkadang kegagalan kueri, karena konkurensi.

Konektor Athena SAP HANA melakukan pushdown predikat untuk mengurangi data yang dipindai oleh kueri. LIMITklausa, predikat sederhana, dan ekspresi kompleks didorong ke konektor untuk mengurangi jumlah data yang dipindai dan mengurangi waktu eksekusi kueri.

Klausul LIMIT

LIMIT NPernyataan mengurangi data yang dipindai oleh kueri. Dengan LIMIT N pushdown, konektor hanya mengembalikan N baris ke Athena.

Predikat

Predikat adalah ekspresi dalam WHERE klausa kueri SQL yang mengevaluasi nilai Boolean dan menyaring baris berdasarkan beberapa kondisi. Konektor Athena SAP HANA dapat menggabungkan ekspresi ini dan mendorongnya langsung ke SAP HANA untuk meningkatkan fungsionalitas dan untuk mengurangi jumlah data yang dipindai.

Operator konektor Athena SAP HANA berikut mendukung pushdown predikat:

• Boolean: DAN, ATAU, TIDAK

• KESETARAAN: SAMA, NOT_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL, GREATER_THAN, GREATER_THAN_OR_EQUAL, IS_DISTINCT_FROM, NULL_IF, IS_NULL

• Aritmatika: TAMBAHKAN, KURANGI, KALIKAN, BAGI, MODULUS, MENIADAKAN

• Lainnya: LIKE_PATTERN, IN

Contoh pushdown gabungan

Untuk kemampuan kueri yang ditingkatkan, gabungkan jenis pushdown, seperti pada contoh berikut:

SELECT * 
FROM my_table 
WHERE col_a > 10 
    AND ((col_a + col_b) > (col_c % col_d))
    AND (col_e IN ('val1', 'val2', 'val3') OR col_f LIKE '%pattern%') 
LIMIT 10;

Kueri passthrough

Konektor SAP HANA mendukung kueri passthrough. Kueri passthrough menggunakan fungsi tabel untuk mendorong kueri lengkap Anda ke sumber data untuk dieksekusi.

Untuk menggunakan kueri passthrough dengan SAP HANA, Anda dapat menggunakan sintaks berikut:

SELECT * FROM TABLE(
        system.query(
            query => 'query string'
        ))

Contoh query berikut mendorong ke bawah query ke sumber data di SAP HANA. Kueri memilih semua kolom dalam customer tabel, membatasi hasilnya menjadi 10.

SELECT * FROM TABLE(
        system.query(
            query => 'SELECT * FROM customer LIMIT 10'
        ))

Informasi lisensi

Dengan menggunakan konektor ini, Anda mengakui penyertaan komponen pihak ketiga, daftar yang dapat ditemukan dalam file pom.xml untuk konektor ini, dan menyetujui persyaratan dalam masing-masing lisensi pihak ketiga yang disediakan dalam file LICENSE.txt di .com. GitHub

Sumber daya tambahan

Untuk informasi versi driver JDBC terbaru, lihat file pom.xml untuk konektor SAP HANA di.com. GitHub

Untuk informasi tambahan tentang konektor ini, kunjungi situs terkait GitHub di.com.