Halaman ini diterjemahkan dari bahasa Inggris dengan bantuan AI. Jika keduanya berbeda, versi bahasa Inggris menjadi acuannya.
AWS_POLICY_EQUAL
Membandingkan dua string JSON kebijakan IAM AWS (atau array tag AWS) dan mengembalikan 1 jika keduanya setara secara semantik menurut aturan evaluasi kebijakan AWS, atau 0 jika tidak.
Lihat juga:
[SELECT] [DESCRIBE] [JSON_EQUAL] [JSON_EXTRACT] [ Tipe data ]
Fungsi aws_policy_equal merupakan fungsi ekstensi kustom StackQL. Fungsi ini menangani perbandingan kebijakan IAM AWS menurut aturan evaluasi kebijakan AWS, yang memperlakukan elemen tertentu (seperti Action, Resource, Principal, dan Tags) sebagai himpunan tak berurutan. Jika kedua argumen merupakan array JSON tingkat atas (misalnya array tag AWS mentah), keduanya juga dibandingkan sebagai himpunan tak berurutan. Fungsi aws_policy_equal tersedia mulai StackQL versi 0.8.175 dan hanya didukung dengan backend SQL default StackQL yang tersemat dan berjalan di memori.
Sintaksis
SELECT AWS_POLICY_EQUAL(policy1, policy2);
Argumen
policy1
String JSON yang merepresentasikan dokumen kebijakan IAM AWS, atau array JSON berisi tag AWS.
policy2
String JSON lain yang merepresentasikan dokumen kebijakan IAM AWS atau array tag untuk dibandingkan dengan argumen pertama.
Kedua argumen harus berupa JSON yang valid. Saat membandingkan dokumen kebijakan, keduanya harus berupa JSON kebijakan IAM AWS yang valid.
Nilai yang dikembalikan
Nilai bilangan bulat: 1 jika dokumen setara secara semantik, 0 jika tidak.
Contoh
Membandingkan kebijakan IAM AWS
SELECT
AssumeRolePolicyDocument as current_policy,
'{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Principal":{"Service":"lambda.amazonaws.com"},"Action":"sts:AssumeRole"}]}' as desired_policy,
AWS_POLICY_EQUAL(AssumeRolePolicyDocument, '{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Principal":{"Service":"lambda.amazonaws.com"},"Action":"sts:AssumeRole"}]}') as compliant
FROM aws.iam.roles
WHERE RoleName = 'my-lambda-role';
/* returns...
|------------------------------------------------------------------|------------------------------------------------------------------|-----------|
| current_policy | desired_policy | compliant |
|------------------------------------------------------------------|------------------------------------------------------------------|-----------|
| {"Version":"2012-10-17","Statement":[{"Effect":"Allow", | {"Version":"2012-10-17","Statement":[{"Effect":"Allow", | 1 |
| "Principal":{"Service":"lambda.amazonaws.com"}, | "Principal":{"Service":"lambda.amazonaws.com"}, | |
| "Action":"sts:AssumeRole"}]} | "Action":"sts:AssumeRole"}]} | |
|------------------------------------------------------------------|------------------------------------------------------------------|-----------|
*/
Membandingkan kebijakan dengan urutan elemen yang berbeda
SELECT
aws_policy_equal(
'{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Action":["s3:GetObject","s3:PutObject"],"Resource":"*"}]}',
'{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Action":["s3:PutObject","s3:GetObject"],"Resource":"*"}]}'
) as unordered_action_equal,
aws_policy_equal(
'{"Version":"2012-10-17","Statement":[{"Condition":{"StringEquals":{"sts:ExternalId":"0000"}},"Action":"sts:AssumeRole","Effect":"Allow","Principal":{"AWS":"arn:aws:iam::123456789012:role/role1"}}]}',
'{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Principal":{"AWS":"arn:aws:iam::123456789012:role/role1"},"Action":"sts:AssumeRole","Condition":{"StringEquals":{"sts:ExternalId":"0000"}}}]}'
) as reordered_elements_equal
;
/* returns...
|------------------------|--------------------------|
| unordered_action_equal | reordered_elements_equal |
|------------------------|--------------------------|
| 1 | 1 |
|------------------------|--------------------------|
*/
Membandingkan format kebijakan yang berbeda (array vs string)
SELECT
aws_policy_equal(
'{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Action":["s3:GetObject"],"Resource":"*"}]}',
'{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Action":"s3:GetObject","Resource":"*"}]}'
) as array_string_equal
;
/* returns...
|--------------------|
| array_string_equal |
|--------------------|
| 1 |
|--------------------|
*/
Membandingkan array tag AWS
API AWS tidak menjamin urutan tag yang dikembalikan. Gunakan aws_policy_equal untuk membandingkan array tag tanpa memperhatikan urutan elemen.
SELECT
aws_policy_equal(
tags,
'[{"Key":"stackql:stack-name","Value":"stackql-serverless"},{"Key":"stackql:stack-env","Value":"dev"},{"Key":"stackql:resource-name","Value":"aws_s3_workspace_bucket"}]'
) as tags_match
FROM aws.s3.buckets
WHERE region = 'us-east-1'
AND name = 'my-workspace-bucket';
/* returns...
|------------|
| tags_match |
|------------|
| 1 |
|------------|
-- Returns 1 regardless of the order AWS returns the tags array
*/
Membandingkan tag sumber daya yang bersarang di dalam objek sumber daya
Jika tag disematkan di dalam objek sumber daya sebagai field Tags, fungsi aws_policy_equal tetap memperlakukan array tag sebagai himpunan tak berurutan.
SELECT
aws_policy_equal(
'{"BucketName":"my-bucket","Tags":[{"Key":"env","Value":"prod"},{"Key":"team","Value":"platform"}]}',
'{"BucketName":"my-bucket","Tags":[{"Key":"team","Value":"platform"},{"Key":"env","Value":"prod"}]}'
) as nested_tags_equal
;
/* returns...
|--------------------|
| nested_tags_equal |
|--------------------|
| 1 |
|--------------------|
*/
Untuk informasi selengkapnya, lihat aws_policy_equal.