إنتقل إلى المحتوى الرئيسي
صفحة مترجمة

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. إذا اختلفت النسختان، فالمرجع هو النسخة الإنجليزية.

استخدام المتغيرات

راجع أيضًا:
[exec] [INSERT]

يمكن تقديم المتغيرات إلى برامج 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