Hologres：Penyamaran data

• Anda tidak dapat mengimpor data dari tabel dan kolom yang memiliki aturan penyamaran ke tabel dan kolom yang tidak memiliki aturan penyamaran. Pesan kesalahan berikut dilaporkan.

  Error: ERROR: The insert table has not set SECURITY LABEL

• Anda tidak dapat menjalankan kueri UNION atau DISTINCT pada tabel yang telah dikonfigurasi aturan penyamaran data. Pesan kesalahan berikut dilaporkan.

  Error: ERROR: UNION is not support on security item

• Penyamaran data dapat memengaruhi kinerja kueri. Tingkat dampaknya bervariasi tergantung pada metode penyamaran dan volume data. Kinerja kueri dapat menurun sebesar 10% hingga 20%. Dalam skenario ekstrem, kinerja dapat menurun secara signifikan.

• Anda tidak dapat mengonfigurasi aturan penyamaran untuk tabel eksternal.

Konfigurasi aturan penyamaran

Hologres memungkinkan Anda mengonfigurasi aturan penyamaran data untuk kolom atau pengguna tertentu. Sebelum melakukan penyamaran data, Anda harus mengaktifkan parameter GUC untuk penyamaran data. Untuk informasi selengkapnya, lihat Persiapan.

• Sintaks

  • Konfigurasi aturan penyamaran untuk kolom.

    Untuk menyamarkan data di beberapa kolom, jalankan pernyataan berikut beberapa kali.

    SECURITY LABEL FOR hg_anon ON COLUMN <tablename>.<col_name> IS <label_name>/'default_value';

  • Konfigurasi aturan penyamaran untuk pengguna.

     SECURITY LABEL FOR hg_anon ON ROLE <user_name> IS '[<label_name>|all]:[masked|unmasked]';

• Parameter

  Parameter	Deskripsi
  hg_anon	hg_anon adalah fungsi ekstensi yang dienkapsulasi dalam Hologres. Anda harus memanggil fungsi ekstensi ini untuk mengaktifkan fitur penyamaran data.
  tablename	Nama tabel yang berisi kolom yang datanya ingin Anda samarkan.
  col_name	Nama kolom yang datanya ingin Anda samarkan.
  label_name	Fungsi penyamaran yang telah ditentukan sebelumnya dalam sistem. Anda dapat menjalankan SHOW hg_anon_labels; untuk melihat nilai label_name yang dikonfigurasi untuk database saat ini.
  user_name	ID akun Alibaba Cloud Anda. Anda dapat memperoleh ID tersebut di halaman Info Pengguna.
  masked|unmasked	masked: Gunakan penyamaran data. unmasked: Jangan gunakan penyamaran data.

  Tabel berikut menjelaskan nilai label_name yang telah ditentukan sebelumnya.

  Tipe data	label_name	Kebijakan Masking	Jenis penyamaran	Deskripsi	Contoh
  TEXT	name	name	mask	Menyamarkan nama.	Sebelum penyamaran: Li Hua. Setelah penyamaran: *Hua. Sebelum penyamaran: Wang Xiaoqiang. Setelah penyamaran: **qiang.
  	email	email	mask	Menyamarkan alamat email.	Sebelum penyamaran: lihuang@alibaba.com. Setelah penyamaran: lih***@alibaba.com.
  	ip	ip	mask	Menyamarkan alamat IP.	Sebelum penyamaran: 1.2.3.4. Setelah penyamaran: 1.*.*.*.
  	id	id	mask	Menyamarkan nomor KTP.	Sebelum penyamaran: 110345188812011234. Setelah penyamaran: 1****************4.
  	phone	phone	mask	Menyamarkan nomor telepon.	Sebelum penyamaran: 13900001234. Setelah penyamaran: *********34.
  	bank_id	bank_id	mask	Menyamarkan nomor rekening bank atau kartu kredit.	Sebelum penyamaran: 2349867902834701928. Setelah penyamaran: ***************1928.
  	hash	md5	hash	Menggunakan algoritma MD5 untuk penyamaran.	Sebelum penyamaran: Jalan Wenyi Barat, Hangzhou, Zhejiang. Setelah penyamaran: dbf894b409d4a2ef17dfd9c7fdcafcd8.
  	first_mask	first_mask	mask	Menentukan aturan first_mask yang hanya menampilkan karakter pertama.	Sebelum penyamaran: 123456789. Setelah penyamaran: 1********.
  INT, FLOAT, dan tipe lainnya	Default	default_value	default_value	Menyamarkan data berdasarkan nilai default. Catatan Jika label_name tidak ada saat Anda mengonfigurasi penyamaran data, sistem akan menggunakan penyamaran nilai default. Pengaturan ini hanya didukung di Hologres V3.1 dan versi selanjutnya.	Daftar berikut menunjukkan pemetaan antara tipe data dan nilai penyamaran default: TEXT/VARCHAR/CHAR: *** BOOLEAN: false INT8/INT4/INT2: 0 TIMESTAMPTZ/TIMESTAMP: 2000-01-01 00:00:00 FLOAT8/FLOAT4/DECIMAL/NUMERIC: 0.0 MONEY: 0 DATE: 2000-01-01 TIME/TIMETZ: waktu saat ini UUID: 00000000-0000-0000-0000-000000000000

Lihat aturan penyamaran yang dikonfigurasi

• Lihat aturan penyamaran yang dikonfigurasi untuk kolom.

  -- Lihat aturan penyamaran yang dikonfigurasi untuk kolom.
  SELECT 
  	c.relname
    ,a.attname
    ,provider
    ,label
  FROM pg_seclabel s 
  INNER JOIN pg_catalog.pg_class c ON s.objoid = c.relfilenode 
  INNER JOIN pg_catalog.pg_attribute a ON s.objoid = a.attrelid 
  WHERE a.attnum = objsubid;

• Lihat aturan penyamaran yang dikonfigurasi untuk pengguna.

  -- Lihat aturan penyamaran yang dikonfigurasi untuk pengguna.
  SELECT
      usename,
      label
  FROM
      pg_shseclabel s
      INNER JOIN pg_catalog.pg_user u ON s.objoid = u.usesysid;

Ubah aturan penyamaran kustom

Jika aturan penyamaran yang dikonfigurasi tidak memenuhi kebutuhan Anda, Anda dapat menyesuaikan aturan penyamaran dengan memodifikasi parameter GUC hg_anon_lables.

• Sintaks

  -- label_name adalah nama kustom, dan method menentukan metode bawaan di Hologres.
  ALTER DATABASE <db_name> SET hg_anon_labels = '[   
  {"label": <label_name1>, "method":<method1>},  
  {"label": <label_name2>, "method":<method2>}, 
  ...  ]'; 

  Setelah menjalankan perintah ALTER DATABASE, pengaturan baru tidak berlaku untuk koneksi saat ini. Anda harus membuat koneksi baru. Anda dapat menjalankan perintah berikut untuk memeriksa apakah pengaturan baru sudah berlaku.

  SHOW hg_anon_enable;

• Contoh

  ALTER DATABASE test_db SET hg_anon_labels = '[
  {"label":"ip", "method":{"desensType":"mask", "type":"ip"}},
  {"label":"email", "method":{"desensType":"mask", "type":"email"}},
  {"label":"name", "method":{"desensType":"mask", "type":"name"}},
  {"label":"first_mask", "method":{"desensType":"mask", "type":"user_define", "before":1, "after":0}},
  {"label":"hash", "method":{"desensType":"hash", "type":"md5", "salt":""}}]';

  Parameter:

  Item penyamaran	Deskripsi	Contoh Penyamaran Data
  {"desensType":"mask", "type":"ip"}	Menyamarkan alamat IP.	192.*.*.*
  {"desensType":"mask", "type":"email"}	Menyamarkan alamat email.	abc***@example.net
  {"desensType":"mask", "type":"name"}	Menyamarkan nama.	*Wu
  {"desensType":"hash", "type":"md5", "salt":""}	Penyamaran hash.	e086aa137fa19f67d27b39d0eca186103228f322c9c98a125554a24f875f0f7e
  {"label":"first_mask", "method":{"desensType":"mask", "type":"user_define", "before":1, "after":0}}{"label":"last_mask", "method":{"desensType":"mask", "type":"user_define", "before":0, "after":1}}	Penyamaran konten kustom.	None

Data sampel

Persiapkan sumber data. Anda juga dapat menggunakan data bisnis Anda sendiri.

-- Buat database.
CREATE DATABASE hg_anon_demo;
-- Buat tabel data sampel.
DROP TABLE IF EXISTS personal_basic_information;
CREATE TABLE personal_basic_information  
(
    name TEXT
    ,email TEXT
    ,ip TEXT
    ,id TEXT 
    ,phone TEXT
    ,bank_id TEXT);
-- Masukkan data sampel.
INSERT INTO personal_basic_information(name,email,ip,id,phone,bank_id) VALUES 
('Zhang San','jiaxi.jx@alibaba-inc.com','127.0.0.1','142732199104050022','18157161223','4514610803067088'),
('Li Si','wb-hy583084@antgroup.com','127.0.0.1','510622198412248000','15757121834','6252470010027800'),
('Li Xiaoyao','wb-hy583084@antgroup.com','172.21.4.234','511025198812271696','18215451832','6252470010027800');

Konfigurasi aturan penyamaran untuk kolom

-- Buat ekstensi hg_anon.
CREATE EXTENSION IF NOT EXISTS hg_anon;

-- Aktifkan penyamaran data untuk database hg_anon_demo.
ALTER DATABASE hg_anon_demo SET hg_anon_enable = on;

-- Konfigurasi aturan penyamaran data untuk setiap kolom.
SECURITY LABEL FOR hg_anon ON COLUMN personal_basic_information.name IS 'name';
SECURITY LABEL FOR hg_anon ON COLUMN personal_basic_information.id IS 'id';
SECURITY LABEL FOR hg_anon ON COLUMN personal_basic_information.phone IS 'phone';
SECURITY LABEL FOR hg_anon ON COLUMN personal_basic_information.email IS 'email';
SECURITY LABEL FOR hg_anon ON COLUMN personal_basic_information.bank_id IS 'bank_id';
SECURITY LABEL FOR hg_anon ON COLUMN personal_basic_information.ip IS 'ip';

Setelah membuat koneksi baru, jalankan perintah berikut untuk melihat hasil penyamaran.

SELECT * FROM personal_basic_information;

Hasil berikut dikembalikan.

name |         email          |      ip      |         id         |    phone    |     bank_id      
------+------------------------+--------------+--------------------+-------------+------------------
 *Si  | wb-***@antgroup.com    | 127.*.*.*    | 5****************0 | *********34 | ************7800
 **yao | wb-***@antgroup.com    | 172.**.*.*** | 5****************6 | *********32 | ************7800
 *San  | jia***@alibaba-inc.com | 127.*.*.*    | 1****************2 | *********23 | ************7088
(3 rows)

Batalkan penyamaran untuk kolom

SECURITY LABEL FOR hg_anon ON COLUMN personal_basic_information.name IS null;
SECURITY LABEL FOR hg_anon ON COLUMN personal_basic_information.id IS null;

Jalankan perintah berikut untuk melihat hasil setelah Anda membatalkan penyamaran untuk kolom.

SELECT name,id FROM personal_basic_information;

Hasil berikut dikembalikan.

SELECT name,id FROM personal_basic_information;
  name  |         id         
--------+--------------------
 Li Si   | 510622198412248000
 Li Xiaoyao | 511025198812271696
 Zhang San   | 142732199104050022
(3 rows)

Batalkan aturan penyamaran untuk pengguna

-- Batalkan semua aturan penyamaran untuk akun BASIC$test.
SECURITY LABEL FOR hg_anon ON ROLE "BASIC$test" IS 'all:unmasked';

Jalankan perintah berikut untuk melihat hasil setelah Anda membatalkan aturan penyamaran untuk pengguna.

SELECT * FROM personal_basic_information;

Hasil berikut dikembalikan.

  name  |          email           |      ip      |         id         |    phone    |     bank_id      
--------+--------------------------+--------------+--------------------+-------------+------------------
 Li Si   | wb-hy583084@antgroup.com | 127.0.0.1    | 510622198412248000 | 15757121834 | 6252470010027800
 Li Xiaoyao | wb-hy583084@antgroup.com | 172.21.4.234 | 511025198812271696 | 18215451832 | 6252470010027800
 Zhang San   | jiaxi.jx@alibaba-inc.com | 127.0.0.1    | 142732199104050022 | 18157161223 | 4514610803067088
(3 rows)

Atur penyamaran untuk kolom JOIN

-- Contoh berikut menunjukkan cara mengonfigurasi penyamaran untuk kolom JOIN.
CREATE TABLE tbl1 (
    id text
);
INSERT INTO tbl1
    VALUES ('142732199102290022');

-- Kolom id pada tabel personal_basic_information sudah disamarkan.
SELECT * FROM personal_basic_information a JOIN tbl1 b ON a.id = b.id;

Hasil berikut dikembalikan.

name | email | ip | id | phone | bank_id | id 
------+-------+----+----+-------+---------+----
(0 rows)