Таблица в SAS (Конвертация)

Краткая информация

Конвертирует таблицу набор данных SAS.

Использование

  • Инструмент поддерживает подключение к SAS Desktop, установленному на локальном компьютере, или подключение к SAS Cloud Analytic Services (CAS). Если вы используете CAS, порядок записей может измениться в процессе конвертации.

  • Параметр Пользовательский файл конфигурации сеанса необходимо использовать для удаленных развертываний SAS, таких как Workspace Server, UNIX и Mainframe. Если SAS установлен на том же компьютере, что и ArcGIS Pro, файл конфигурации не требуется.

    Более подробно о конфигурациях сеансов SAS

  • Укажите набор данных SAS в форме libref.tablename, где libref - имя библиотеки SAS или CAS, а tablename - имя набора данных SAS. Например, набор данных SASUSER.MYTABLE ссылается на набор данных SAS с именем MYTABLE в библиотеке SASUSER.

  • Библиотеки SAS, имена наборов данных и имена столбцов не чувствительны к регистру. Например, SASUSER.MYTABLE воспринимается одинаково для вариантов sasuser.mytable и SASUser.MyTable.

  • Число записей, которое может быть конвертировано, зависит до объема доступной памяти вашего компьютера.

  • Для локального развертывания SAS библиотеки SASUSER, SASHELP, MAPS, MAPSSAS и MAPSGFK доступны по умолчанию. Для использования пользовательской библиотеки, необходимо задать libref для файла SAS Autoexec.

    Более подробно о конфигурациях Autoexec

  • При подключении к CAS вы можете авторизовать свои учетные данные двумя способами:

    • Указать имя пользователя и пароль в параметрах Имя пользователя CAS и Пароль. Пароль будет скрыт и недоступен в истории геообработки.
    • Указать файл авторизации (Authinfo) используя параметр Файл авторизации CAS (Authinfo) в котором содержится имя пользователя и закодированный пароль. Это позволит вам избежать постоянного ввода пароля каждый раз при запуске инструмента.

      Чтобы автоматически использовать файл Authinfo каждый раз при запуске инструмента, назовите файл _authinfo (включая нижнее подчеркивание) и сохраните их в пользовательскую папку Windows (обычно C:\Users\<username>). У файла может быть любое расширение, например _authinfo.txt или _authinfo.netrc. Если файл хранится в вашей пользовательской папке, параметр Файл авторизации CAS (Authinfo) будет автоматически заполнен с подстановкой этого файла. Это позволит вам избежать поиска этого файла каждый раз при запуске инструмента.

      Файл Authinfo может содержать информацию о подключении для нескольких хостов и портов, но в самом простом случае, при подключении одного пользователя к одному хосту и порту, файл Authinfo будет состоять из одной строки со следующим синтаксисом:

      default user MYUSERNAME password {SAS004}1234567890ABCDEFGHIJKLMNOPQRSTUVWXYZ

      Вы можете декодировать пароль в файле с помощью операции PROC PWENCODE SAS.

      Более подробно о создании файлов Authinfo и кодировке паролей

  • Библиотека WORK - временная рабочая область, которая создается при запуске сеанса SAS, и по окончании сеанса все файлы удаляются. Инструмент запускается и закрывает новый сеанс SAS во время операции, так что вы не должны использовать библиотеку WORK в этом инструменте.

Параметры

ПодписьОписаниеТип данных
Входная таблица

Входная таблица.

Table View
Выходной набор данных SAS (libref.tablename)

Выходной набор данных SAS. Укажите набор данных в форме libref.table, где libref - имя библиотеки SAS, а table - имя таблицы SAS.

String
Заменить набор данных SAS
(Дополнительный)

Указывает, будут ли выходные данные перезаписывать существующие наборы данных SAS.

  • Отмечено - выходные данные будут перезаписывать существующие наборы данных SAS.
  • Не отмечено - выходные данные не будут перезаписывать существующие наборы данных SAS. Это значение по умолчанию

Boolean
Использовать описания домена и подтипа
(Дополнительный)

Определяет, будут ли описания доменов и подтипов включены в выходной набор данных SAS.

  • Отмечено - описания доменов и подтипов будут включены в выходной набор данных SAS.
  • Не отмечено - описания доменов и подтипов не будут включены в выходной набор данных SAS. Это значение по умолчанию

Boolean
Выгрузить Набор данных SAS в SAS Cloud Analytic Services (CAS)
(Дополнительный)

Определяет, будет ли выходной набор данных SAS выгружен в CAS или сохранен в локальной библиотеке SAS.

  • Отмечено - выходной набор данных SAS будет выгружен в CAS.
  • Не отмечено - выходной набор данных SAS будет сохранен в локальную библиотеку SAS. Это значение по умолчанию

Boolean
CAS Hostname URL
(Дополнительный)

URL-адрес хоста CAS.

String
Порт
(Дополнительный)

Порт подключения CAS.

Long
Имя пользователя CAS
(Дополнительный)

Имя пользователя для подключения CAS.

String
Пароль
(Дополнительный)

Пароль для подключения CAS. Пароль скрыт и недоступен после запуска инструмента.

String Hidden
Пользовательский файл конфигурации сеанса
(Дополнительный)

Это - файл, определяющий пользовательские конфигурации для сеанса SAS. Этот файл необходим только для пользовательских локальных или удаленных развертываний SAS.

File
Файл авторизации CAS (Authinfo)
(Дополнительный)

Файл содержит информацию по авторизации при подключении к CAS. Файл должен содержать имя пользователя и закодированный пароль для подключения. Если указывается файл, параметры Имя пользователя CAS и пароль не указываются.

File

arcpy.conversion.TableToSAS(in_table, out_sas_dataset, {replace_sas_dataset}, {use_domain_and_subtype_description}, {use_cas_connection}, {hostname}, {port}, {username}, {password}, {custom_cfg_file}, {authinfo_file})
ИмяОписаниеТип данных
in_table

Входная таблица.

Table View
out_sas_dataset

Выходной набор данных SAS. Укажите набор данных в форме libref.table, где libref - имя библиотеки SAS, а table - имя таблицы SAS.

String
replace_sas_dataset
(Дополнительный)

Определяет, будет ли перезаписан существующий набор данных SAS выходным набором.

  • OVERWRITEВыходные данные будут перезаписывать существующие наборы данных SAS.
  • NO_OVERWRITEВыходные данные не будут перезаписывать существующие наборы данных SAS. Это значение по умолчанию
Boolean
use_domain_and_subtype_description
(Дополнительный)

Определяет, будут ли описания доменов и подтипов включены в выходной набор данных SAS.

  • USE_DOMAINОписания доменов и подтипов будут включены в выходной набор данных SAS.
  • NO_DOMAINОписания доменов и подтипов не будут включены в выходной набор данных SAS. Это значение по умолчанию
Boolean
use_cas_connection
(Дополнительный)

Определяет, будет ли выходной набор данных SAS выгружен в CAS или сохранен в локальной библиотеке SAS.

  • USE_CASВыходной набор данных SAS будет выгружен в CAS.
  • LOCAL_SASВыходной набор данных SAS будет сохранен в локальную библиотеку SAS. Это значение по умолчанию
Boolean
hostname
(Дополнительный)

URL-адрес хоста CAS.

String
port
(Дополнительный)

Порт подключения CAS.

Long
username
(Дополнительный)

Имя пользователя для подключения CAS.

String
password
(Дополнительный)

Пароль для подключения CAS. Пароль скрыт и недоступен после запуска инструмента.

String Hidden
custom_cfg_file
(Дополнительный)

Это - файл, определяющий пользовательские конфигурации для сеанса SAS. Этот файл необходим только для пользовательских локальных или удаленных развертываний SAS.

File
authinfo_file
(Дополнительный)

Файл содержит информацию по авторизации при подключении к CAS. Файл должен содержать имя пользователя и закодированный пароль для подключения. Если указывается файл, параметры username и password не указываются.

File

Пример кода

TableToSAS, пример 1 (окно Python)

Ниже в окне Python показано, как использовать функцию TableToSAS с локальной установкой SAS.


import arcpy
arcpy.conversion.TableToSAS("MyData", "sasuser.MySASData", "OVERWRITE",
                            "USE_DOMAIN", "LOCAL_SAS")
TableToSAS, пример 2 (автономный скрипт)

Этот автономный скрипт Python демонстрирует пример использования функции TableToSAS с подключением к CAS.


# Import system modules
import arcpy
import getpass

# Provide tool parameters
in_table = "MyData"
out_SASDS = "casuser.MySASData"
replace_output = "OVERWRITE"
field_domains = "USE_DOMAIN"
connection = "USE_CAS"
hosturl = https://XXX.vdp.sas.com/XXX-XXXXX-default-http/ 
port = 100
username = "CAS_user"

# Provide password securely
password = getpass.getpass()

try:
    # Set the workspace and run the tool.
    arcpy.env.workspace = r"C:\\TableToSAS\\MyData.gdb"
    arcpy.conversion.TableToSAS(in_table, out_SASDS, replace_output, 
                                field_domains, connection, hosturl, port, 
                                username, password)
except arcpy.ExecuteError:
    # If an error occurred when running the tool, print the error message.
    print(arcpy.GetMessages())

Параметры среды

Этот инструмент не использует параметры среды геообработки

Информация о лицензиях

  • Basic: Да
  • Standard: Да
  • Advanced: Да

Связанные разделы