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

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

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

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

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

Примечание:

По состоянию на сентябрь 2025 года пакет Python swat несовместим с Python версии 3.13, которая является необходимой для ArcGIS Pro. Поскольку соединения CAS зависят от этого пакета, попытка запустить этот инструмент с помощью CAS приведет к ошибке. Поддержка подключений CAS будет снова включена, когда пакет swat станет совместим с версией , входящей в ArcGIS Pro.
Параметр Пользовательский файл конфигурации сеанса необходимо использовать для удаленных развертываний , таких как Workspace Server, UNIX и Mainframe. Если CAS установлен на том же компьютере, что и ArcGIS Pro, файл конфигурации не требуется.

Узнайте больше о настройках сессий 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 - временная рабочая область, которая создается при запуске сеанса , и по окончании сеанса все файлы удаляются. Инструмент запускается и закрывает новый сеанс во время операции, так что вы не должны использовать библиотеку 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.

# 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())

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

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

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

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