Подпись | Описание | Тип данных |
Входная таблица | Входная таблица. | Table View |
Выходной набор данных SAS (libref.tablename) | Выходной набор данных SAS. Укажите набор данных в форме libref.table, где libref - имя библиотеки SAS, а table - имя таблицы SAS. | String |
Заменить набор данных SAS (Дополнительный) | Указывает, будут ли выходные данные перезаписывать существующие наборы данных SAS.
| Boolean |
Использовать описания домена и подтипа (Дополнительный) | Определяет, будут ли описания доменов и подтипов включены в выходной набор данных SAS.
| Boolean |
Выгрузить Набор данных SAS в SAS Cloud Analytic Services (CAS) (Дополнительный) | Определяет, будет ли выходной набор данных SAS выгружен в CAS или сохранен в локальной библиотеке SAS.
| Boolean |
CAS Hostname URL (Дополнительный) | URL-адрес хоста CAS. | String |
Порт (Дополнительный) | Порт подключения CAS. | Long |
Имя пользователя CAS (Дополнительный) | Имя пользователя для подключения CAS. | String |
Пароль (Дополнительный) | Пароль для подключения CAS. Пароль скрыт и недоступен после запуска инструмента. | String Hidden |
Пользовательский файл конфигурации сеанса (Дополнительный) | Это - файл, определяющий пользовательские конфигурации для сеанса SAS. Этот файл необходим только для пользовательских локальных или удаленных развертываний SAS. | File |
Файл авторизации CAS (Authinfo) (Дополнительный) | Файл содержит информацию по авторизации при подключении к CAS. Файл должен содержать имя пользователя и закодированный пароль для подключения. Если указывается файл, параметры Имя пользователя CAS и пароль не указываются. | File |
Краткая информация
Конвертирует таблицу набор данных SAS.
Использование
Инструмент поддерживает подключение к SAS Desktop, установленному на локальном компьютере, или подключение к SAS Cloud Analytic Services (CAS). Если вы используете CAS, порядок записей может измениться в процессе конвертации.
Параметр Пользовательский файл конфигурации сеанса необходимо использовать для удаленных развертываний SAS, таких как Workspace Server, UNIX и Mainframe. Если SAS установлен на том же компьютере, что и ArcGIS AllSource, файл конфигурации не требуется.
Укажите набор данных 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.
При подключении к 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 в этом инструменте.
Параметры
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 выходным набором.
| Boolean |
use_domain_and_subtype_description (Дополнительный) | Определяет, будут ли описания доменов и подтипов включены в выходной набор данных SAS.
| Boolean |
use_cas_connection (Дополнительный) | Определяет, будет ли выходной набор данных SAS выгружен в CAS или сохранен в локальной библиотеке 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 |
Пример кода
Ниже в окне Python показано, как использовать функцию TableToSAS с локальной установкой SAS.
import arcpy
arcpy.conversion.TableToSAS("MyData", "sasuser.MySASData", "OVERWRITE",
"USE_DOMAIN", "LOCAL_SAS")
Этот автономный скрипт 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())