تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. إذا اختلفت النسختان، فالمرجع هو النسخة الإنجليزية.
استخدام المتغيرات
يمكن تقديم المتغيرات إلى برامج StackQL النصية في صورة بيانات تكوين. يمكن أن تكون بيانات تكوين StackQL بتنسيق json أو jsonnet.
يقدم Jsonnet ميزات إضافية مثل المنطق الشرطي والاستيراد والوراثة، بالإضافة إلى بنى الحلقات التكرارية.
يمكن تقديم البيانات من خلال ملفات json أو jsonnet يشار إليها عبر المعلمة --iqldata للأمر stackql exec، أو يمكن تضمينها في برنامج نصي iql باستخدام المزخرفين <<< و>>> كما هو موضح هنا:
<<<jsonnet
//
// jsonnet data
//
>>>
/* stackql statements ... */
مثال على تكوين Jsonnet
يوضح المثال التالي استخدام Jsonnet لتقديم بيانات التكوين إلى برنامج نصي لـ StackQL. يتم تقديم البيانات باستخدام المعلمة --iqldata للأمر exec كما هو موضح أدناه:
stackql exec -i myscript.iql \
--iqldata vars.jsonnet \
--auth '{ "google": { "type": "service_account", "credentialsfilepath": "stackql-demo.json" } }'
بيانات Jsonnet
باستخدام jsonnet، يمكنك إعادة استخدام المتغيرات واستخدام المصفوفات داخل بنى الحلقات التكرارية في تعليمات StackQL البرمجية الخاصة بك. يمثل jsonnet التالي محتويات الملف vars.jsonnet المشار إليه في المعلمة --iqldata.
// variables
local project = 'stackql-demo';
local region = 'australia-southeast1';
local name = 'myapp';
local nw_name = name + '-vpc';
local nw_self_link = 'https://compute.googleapis.com/compute/v1/projects/' + project + '/global/networks/' + nw_name + '/';
{
// global config
global: {
project: project,
},
// firewall rules
firewalls: [
{
allowed: [{IPProtocol: 'tcp'}, {IPProtocol: 'udp'}, {IPProtocol: 'icmp'}],
direction: 'INGRESS',
name: name + '-allow-internal-fw',
network: nw_self_link,
sourceRanges: ['10.240.0.0/24', '10.200.0.0/16']
},
{
allowed: [{IPProtocol: 'tcp', ports: ['22']}, {IPProtocol: 'tcp', ports: ['6443']},{IPProtocol: 'icmp'}],
direction: 'INGRESS',
name: name + '-allow-external-fw',
network: nw_self_link,
sourceRanges: ['0.0.0.0/0']
}
],
}
الإشارة إلى بيانات Jsonnet في جملة StackQL
يوضح مقتطف التعليمات البرمجية التالي كيفية الإشارة إلى قيم jsonnet من أمر StackQL.
--
-- create firewall rules
--
{{range .firewalls}}
INSERT /*+ AWAIT */ INTO google.compute.firewalls
(
project,
data__name,
data__network,
data__direction,
data__sourceRanges,
data__allowed
)
SELECT
'{{ .global.project }}',
'{{.name}}',
'{{.network}}',
'{{.direction}}',
'{{.sourceRanges}}',
'{{.allowed}}';
{{end}}
تحميل المتغيرات الخارجية باستخدام Jsonnet
توضح مقتطفات التعليمات البرمجية التالية كيفية تحميل متغيرات خارجية في ملف تكوين Jsonnet يستخدم لإنشاء استعلام StackQL من القالب.
استعلام StackQL (env-var-input.iql)
INSERT /*+ AWAIT */ INTO google.compute.networks
(
project,
data__name,
data__autoCreateSubnetworks,
data__routingConfig
)
SELECT
'{{ .global.project }}',
'{{ .network.name }}',
{{ .network.autoCreateSubnetworks }},
'{{ .network.routingConfig }}';
ملف بيانات Jsonnet (vars.jsonnet)
// variables
local name = 'env-var-input-demo';
local project = std.extVar("project");
{
// global config
global: {
project: project,
},
// network
network: {
autoCreateSubnetworks: false,
name: name + '-vpc',
routingConfig: {routingMode: 'REGIONAL'}
},
}
التنفيذ من سطر الأوامر
/path/to/stackql exec -i $(pwd)/env-var-input.iql --var project=stackql-demo --iqldata $(pwd)/vars.jsonnet
مثال على تكوين Json
يمكن أيضًا استخدام json بسيط لتقديم بيانات التكوين إلى برنامج نصي لـ StackQL كما هو موضح أدناه:
stackql exec -i myscript.iql \
--iqldata vars.json \
--auth '{ "google": { "type": "service_account", "credentialsfilepath": "stackql-demo.json" } }'
بيانات Json
تمثل بيانات json التالية محتويات الملف vars.json المشار إليه في المعلمة --iqldata.
{
"project": "stackql-demo",
"firewalls": [
{
"allowed": [{"IPProtocol": "tcp"}, {"IPProtocol": "udp"}, {"IPProtocol": "icmp"}],
"direction": "INGRESS",
"name": "myapp-allow-internal-fw",
"network": "https://compute.googleapis.com/compute/v1/projects/stackql-demo/global/networks/myapp-vpc/",
"sourceRanges": ["10.240.0.0/24", "10.200.0.0/16"]
},
{
"allowed": [{"IPProtocol": "tcp", "ports": ["22"]}, {"IPProtocol": "tcp", "ports": ["6443"]},{"IPProtocol": "icmp"}],
"direction": "INGRESS",
"name": "myapp-allow-external-fw",
"network": "https://compute.googleapis.com/compute/v1/projects/stackql-demo/global/networks/myapp-vpc/",
"sourceRanges": ["0.0.0.0/0"]
}
]
}
الإشارة إلى بيانات Json في جملة StackQL
يشار إلى البيانات الموضحة أعلاه في جملة INSERT في StackQL كما هو موضح هنا:
INSERT /*+ AWAIT */ INTO google.compute.firewalls
(
project,
data__name,
data__network,
data__direction,
data__sourceRanges,
data__allowed
)
SELECT
'{{ project }}',
'{{ firewalls[0].name }}',
'{{ firewalls[0].network }}',
'{{ firewalls[0].direction }}',
'{{ firewalls[0].sourceRanges }}',
'{{ firewalls[0].allowed }}';
INSERT /*+ AWAIT */ INTO google.compute.firewalls
(
project,
data__name,
data__network,
data__direction,
data__sourceRanges,
data__allowed
)
SELECT
'{{ project }}',
'{{ firewalls[1].name }}',
'{{ firewalls[1].network }}',
'{{ firewalls[1].direction }}',
'{{ firewalls[1].sourceRanges }}',
'{{ firewalls[1].allowed }}';
خيار التشغيل التجريبي لمعاينة الأمر
يمكنك استخدام الخيار --dryrun لإخراج برنامج نصي لـ StackQL بعد معالجته مسبقًا باستخدام البرنامج النصي للإدخال وملف بيانات json أو jsonnet كما هو موضح أدناه:
./stackql exec -i myscript.iql \
--iqldata vars.json \
--auth '{ "google": { "type": "service_account", "credentialsfilepath": "stackql-demo.json" } }' \
--dryrun \
--output text