Управление глобальными переменными DLI

DLI позволяет задавать переменные, часто используемые при разработке job, в виде глобальных переменных в консоли управления DLI. Это исключает повторные определения при редактировании job и снижает затраты на разработку и обслуживание. Глобальные переменные можно использовать для замены длинных и сложных переменных, упрощая сложные параметры и повышая читаемость операторов SQL.

В этом разделе описывается, как создать глобальную переменную.

1. В панели навигации консоли DLI выберите Global Configuration > Global Variables.
2. На странице Global Variables нажмите Create в правом верхнем углу, чтобы создать глобальную переменную.

   Table 1 Параметры глобальной переменной

   Параметр	Описание
   Переменная	Имя созданной глобальной переменной.
   Значение	Значение глобальной переменной.

3. После создания глобальной переменной используйте {{xxxx}} в операторе SQL, чтобы заменить значение параметра, установленное как глобальная переменная. xxxx указывает имя переменной. Например, если вы задаете глобальную переменную abc для представления имени таблицы, замените фактическое имя таблицы на {{abc}} в операторе создания таблицы.

   create table {{table_name}} (String1 String, int4 int, varchar1 varchar(10))
     partitioned by (int1 int,int2 int,int3 int)
   
   

   Note

   Не используйте глобальные переменные в OPTIONS операторов создания таблицы.

   Связанные операции:

   • Изменение глобальной переменной

     На странице Global Variables найдите нужную переменную и нажмите Modify в столбце Operation.

     Note

     Если в одном проекте под одной учётной записью существует несколько глобальных переменных с одинаковым именем, удалите избыточные глобальные переменные, чтобы обеспечить уникальность глобальных переменных в этом проекте. В этом случае все пользователи, имеющие разрешение изменять глобальные переменные, могут менять значения переменных.

   • Удаление глобальной переменной

     На странице Global Variables нажмите Delete в столбце Operation переменной, чтобы удалить её значение.

     Note

     • Если в одном проекте под одной учётной записью существует несколько глобальных переменных с одинаковым именем, сначала удалите глобальные переменные, созданные пользователем. Если же глобальные переменные уникальны, все пользователи, имеющие разрешение на удаление, могут удалять глобальные переменные.
     • После удаления переменной её нельзя использовать в SQL‑операторах.

Вы можете назначать различным пользователям разные глобальные переменные с помощью настроек разрешений. Администратор и владельцы глобальных переменных имеют все разрешения. Для них не требуется задавать разрешения, и их разрешения на глобальные переменные не могут быть изменены другими пользователями.

При настройке глобальных переменных для нового пользователя группа пользователя должна иметь разрешение Tenant Guest.

• Назначение разрешений на глобальную переменную пользователю
  1. В панели навигации слева в консоли DLI выберите Global Configuration > Global Variables. На открывшейся странице найдите нужную глобальную переменную и нажмите Set Permission в столбце Operation. На открывшейся странице User Permissions вы можете предоставлять, задавать и отзывать разрешения на глобальную переменную для пользователей.
  2. Нажмите Grant Permission в правом верхнем углу.

     Table 2 Параметры глобальной переменной

     Параметр	Описание
     Username	Имя пользователя IAM, которому предоставлены разрешения ПРИМЕЧАНИЕ: Это имя пользователя должно быть существующим именем пользователя IAM.
     Разрешения	Update: Это разрешение позволяет обновлять глобальную переменную. Delete: Это разрешение позволяет удалять глобальную переменную. Grant Permission: Это разрешение позволяет предоставлять разрешения на глобальную переменную другим пользователям. Revoke Permission: Это разрешение позволяет отзывать разрешения на глобальную переменную, предоставленные другим пользователям, но не позволяет отзывать разрешения владельца глобальной переменной. View Other User's Permissions: Это разрешение позволяет просматривать разрешения на глобальную переменную у других пользователей.

• Предоставление разрешений на глобальную переменную пользователю

  На странице User Permissions найдите нужного пользователя IAM и нажмите Set Permission в столбце Operation. Table 2 перечисляет параметры разрешений.

  Если все варианты разрешений неактивны (выделены серым), это означает, что у вас нет полномочий изменять разрешения для этой глобальной переменной. Вы можете запросить разрешение на изменение у пользователей, имеющих соответствующие права, например у администратора или владельцев группы.

• Отзыв разрешений на глобальную переменную у пользователя

  На странице User Permissions найдите нужного пользователя IAM и нажмите Revoke Permission в столбце Operation. После завершения операции отзыва пользователь IAM больше не будет иметь никаких разрешений на глобальную переменную.