MENGUBAH KEBIJAKAN KEAMANAN (Transact-SQL)

Berlaku untuk: SQL Server 2016 (13.x) dan versi yang lebih baru Azure SQL DatabaseAzure SQL Managed Instancetitik akhir analitik SQL di Microsoft FabricWarehouse di Microsoft Fabric

Mengubah kebijakan keamanan.

Konvensi sintaks transact-SQL

Sintaks

ALTER SECURITY POLICY schema_name.security_policy_name   
    (  
        { ADD { FILTER | BLOCK } PREDICATE tvf_schema_name.security_predicate_function_name   
           ( { column_name | arguments } [ , ...n ] ) ON table_schema_name.table_name   
           [ <block_dml_operation> ]  }   
        | { ALTER { FILTER | BLOCK } PREDICATE tvf_schema_name.new_security_predicate_function_name   
             ( { column_name | arguments } [ , ...n ] ) ON table_schema_name.table_name   
           [ <block_dml_operation> ] }  
        | { DROP { FILTER | BLOCK } PREDICATE ON table_schema_name.table_name }   
        | [ <additional_add_alter_drop_predicate_statements> [ , ...n ] ]  
    )    [ WITH ( STATE = { ON | OFF } ) ]  
    [ NOT FOR REPLICATION ]  
[;]  
  
<block_dml_operation>  
    [ { AFTER { INSERT | UPDATE } }   
    | { BEFORE { UPDATE | DELETE } } ]  

Argumen

security_policy_name

Nama kebijakan keamanan. Nama kebijakan keamanan harus memenuhi aturan untuk pengidentifikasi dan harus unik dalam database dan skemanya.

schema_name

Adalah nama skema tempat kebijakan keamanan berada. schema_name diperlukan karena pengikatan skema.

[ FILTER | BLOKIR ]

Jenis predikat keamanan untuk fungsi yang terikat ke tabel target. FILTER predikat memfilter baris yang tersedia untuk membaca operasi secara diam-diam. BLOCK predikat secara eksplisit memblokir operasi penulisan yang melanggar fungsi predikat.

tvf_schema_name.security_predicate_function_name

Adalah fungsi nilai tabel sebaris yang Anda gunakan sebagai predikat dan yang Anda terapkan pada kueri terhadap tabel target. Paling banyak, Anda dapat menentukan satu predikat keamanan untuk operasi DML tertentu terhadap tabel tertentu. Buat fungsi nilai tabel sebaris menggunakan SCHEMABINDING opsi .

{ column_name | argumen }

Nama kolom atau ekspresi yang digunakan sebagai parameter untuk fungsi predikat keamanan. Kolom apa pun pada tabel target dapat digunakan sebagai argumen untuk fungsi predikat. Ekspresi yang mencakup literal, bawaan, dan ekspresi yang menggunakan operator aritmatika dapat digunakan.

table_schema_name.table_name

Adalah tabel target untuk predikat keamanan. Beberapa kebijakan keamanan yang dinonaktifkan dapat menargetkan satu tabel untuk operasi DML tertentu, tetapi hanya satu yang dapat diaktifkan pada waktu tertentu.

<block_dml_operation>

Operasi DML tertentu untuk predikat blok yang diterapkan. AFTER menentukan predikat dievaluasi pada nilai baris setelah operasi DML dilakukan (INSERT atau UPDATE). BEFORE menentukan predikat dievaluasi pada nilai baris sebelum operasi DML dilakukan (UPDATE atau DELETE). Jika tidak ada operasi yang ditentukan, predikat akan berlaku untuk semua operasi.

Anda tidak dapat MENGUBAH operasi untuk predikat blok yang diterapkan karena operasi digunakan untuk mengidentifikasi predikat secara unik. Sebagai gantinya, Anda harus menghilangkan predikat dan menambahkan predikat baru untuk operasi baru.

WITH ( STATE = { ON | OFF } )

Mengaktifkan atau menonaktifkan kebijakan keamanan agar tidak menegakkan predikat keamanannya terhadap tabel target. Jika tidak ditentukan, kebijakan keamanan yang dibuat diaktifkan.

BUKAN UNTUK REPLIKASI

Menunjukkan kebijakan keamanan tidak boleh dijalankan ketika agen replikasi memodifikasi objek target. Untuk informasi selengkapnya, lihat Mengontrol Perilaku Pemicu dan Batasan Selama Sinkronisasi (Pemrograman Transact-SQL Replikasi).

table_schema_name.table_name

Adalah tabel target untuk predikat keamanan yang diterapkan. Beberapa kebijakan keamanan yang dinonaktifkan dapat menargetkan satu tabel, tetapi hanya satu yang dapat diaktifkan pada waktu tertentu.

Keterangan

Pernyataan KEBIJAKAN KEAMANAN ALTER berada dalam cakupan transaksi. Jika transaksi digulung balik, pernyataan juga digulung balik.

Saat menggunakan fungsi predikat dengan tabel yang dioptimalkan memori, kebijakan keamanan harus menyertakan SCHEMABINDING dan menggunakan WITH NATIVE_COMPILATION petunjuk kompilasi. Argumen SCHEMABINDING tidak dapat diubah dengan ALTER pernyataan karena berlaku untuk semua predikat. Untuk mengubah pengikatan skema, Anda harus menghilangkan dan membuat ulang kebijakan keamanan.

Predikat blok dievaluasi setelah operasi DML yang sesuai dijalankan. Dengan demikian, ada bahaya kueri READ UNCOMMITTED dapat melihat nilai sementara yang akan digulung balik.

Izin

Memerlukan ALTER ANY SECURITY POLICY izin.

Selain itu, izin berikut diperlukan untuk setiap predikat yang ditambahkan:

  • SELECT dan REFERENCES izin pada fungsi yang digunakan sebagai predikat.
  • REFERENCES izin pada tabel target yang terikat pada kebijakan.
  • REFERENCES izin pada setiap kolom dari tabel target yang digunakan sebagai argumen.

Contoh

Contoh berikut menunjukkan penggunaan ALTER SECURITY POLICY sintaksis. Untuk contoh skenario kebijakan keamanan lengkap, lihat Keamanan tingkat baris.

J. Menambahkan predikat tambahan ke kebijakan

Sintaks berikut mengubah kebijakan keamanan, menambahkan predikat filter pada mytable tabel.

ALTER SECURITY POLICY pol1   
    ADD FILTER PREDICATE schema_preds.SecPredicate(column1)   
    ON myschema.mytable;  

B. Mengaktifkan kebijakan yang sudah ada

Contoh berikut menggunakan sintaks ALTER untuk mengaktifkan kebijakan keamanan.

ALTER SECURITY POLICY pol1 WITH ( STATE = ON );  

C. Menambahkan dan menghilangkan beberapa predikat

Sintaks berikut mengubah kebijakan keamanan, menambahkan predikat filter pada mytable1 tabel dan mytable3 , dan menghapus predikat filter pada mytable2 tabel.

ALTER SECURITY POLICY pol1  
ADD FILTER PREDICATE schema_preds.SecPredicate1(column1)   
    ON myschema.mytable1,  
DROP FILTER PREDICATE   
    ON myschema.mytable2,  
ADD FILTER PREDICATE schema_preds.SecPredicate2(column2, 1)   
    ON myschema.mytable3;  

D. Mengubah predikat pada tabel

Sintaks berikut mengubah predikat filter yang myschema.mytable ada pada tabel menjadi SecPredicate2 fungsi.

ALTER SECURITY POLICY pol1  
    ALTER FILTER PREDICATE schema_preds.SecPredicate2(column1)  
        ON myschema.mytable;  

E. Mengubah predikat blok

Mengubah fungsi predikat blok untuk operasi pada tabel.

ALTER SECURITY POLICY rls.SecPol  
    ALTER BLOCK PREDICATE rls.tenantAccessPredicate_v2(TenantId) 
    ON dbo.Sales AFTER INSERT;