Таблица в 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 библиотеки 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 в этом инструменте.

Подпись	Объяснение	Тип данных
Входная таблица	Входная таблица.	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. Отмечено–Выходной набор данных 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`–Выходные данные будут перезаписывать существующие наборы данных . `NO_OVERWRITE`–Выходные данные не будут перезаписывать существующие наборы данных. Используется по умолчанию.	Boolean
use_domain_and_subtype_description (Дополнительный)	Определяет, будут ли описания доменов и подтипов включены в выходной набор данных SAS. `USE_DOMAIN`–Описания доменов и подтипов будут включены в выходной набор данных. `NO_DOMAIN`–Описания доменов и подтипов не будут включены в выходной набор данных. Используется по умолчанию.	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.

# 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: Да