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

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

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

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

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

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

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

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

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

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

  • Форматы столбцов в наборе данных SAS не сохраняются в выходной таблице.

  • Для локального развертывания 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 в этом инструменте.

Параметры

ПодписьОписаниеТип данных
Входной набор данных SAS (libref.tablename)

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

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

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

Table
Загрузить Набор данных 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.SASToTable(in_sas_dataset, out_table, {use_cas_connection}, {hostname}, {port}, {username}, {password}, {custom_cfg_file}, {authinfo_file})
ИмяОписаниеТип данных
in_sas_dataset

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

String
out_table

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

Table
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

Пример кода

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

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


import arcpy
arcpy.conversion.SASToTable("sashelp.cars", "CarsTable", "LOCAL_SAS")
SASToTable, пример 2 (автономный скрипт)

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


# Import system modules
import arcpy
import getpass

# Provide tool parameters
in_SASDS = "casuser.MySASData"
out_table = "MyEsriData"
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:\\SASToTable\\MyData.gdb"
    arcpy.conversion.SASToTable(in_SASDS, out_table, connection, hosturl,
                     port, username, password)

except arcpy.ExecuteError:
    # If an error occurred when running the tool, print the error message.
    print(arcpy.GetMessages())

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

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

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