テーブル → SAS (変換ツール)

サマリー

テーブルを SAS データセットに変換します。

使用法

このツールは、ローカルコンピューターにインストールされている SAS Desktop への接続または SAS CAS (Cloud Analytic Services) への接続に対応しています。 CAS を使用している場合は、変換中にレコードの順序が変更されることがあります。

注意:

2025 年 9 月以降、swat Python パッケージは Python バージョン 3.13 との互換性を失います。このバージョンは、ArcGIS Pro 3.6 の必須バージョンです。 CAS の接続はこのパッケージに依存するため、CAS を使用してこのツールを実行しようとするとエラーが発生します。 CAS 接続のサポートは、swat パッケージが ArcGIS Pro に付属している Python バージョンとの互換性を確保すると再び有効になります。
Workspace Server、UNIX、Mainframe など、リモートデプロイメントの SAS の場合、カスタムセッション構成ファイル パラメーターを使用する必要があります。 SAS が ArcGIS Pro と同じコンピューターにインストールされている場合、構成ファイルは不要です。

SAS セッションの構成の詳細
libref.tablename の形式で SAS データセットを指定します。ここで、libref は SAS または CAS ライブラリーの名前を表し、tablename は SAS データセットの名前を表します。たとえば、SASUSER.MYTABLE は、SASUSER ライブラリーに格納されている MYTABLE という SAS データセットを表しています。
SAS ライブラリー、データセット名、および列名では、大文字と小文字が区別されません。たとえば、SASUSER.MYTABLE は sasuser.mytable および SASUser.MyTable と同じであると見なされます。
変換できるレコードの数は、コンピューターのメモリーの空き容量によって異なります。
ローカルの SAS デプロイメントの場合、デフォルトで SASUSER、SASHELP、MAPS、MAPSSAS、MAPSGFK の各ライブラリーを利用できます。カスタムライブラリーを使用するには、SAS Autoexec ファイルで libref を定義する必要があります。

Autoexec 構成の詳細
CAS に接続する際、以下の方法で認証情報を認証できます:
- CAS ユーザー名 パラメーターと パスワード パラメーターを使用して、ユーザー名とパスワードを指定します。パスワードは非表示であり、ジオプロセシング履歴からアクセスできません。
- CAS 認証 (Authinfo) ファイル パラメーターを使用して、ユーザー名とエンコードされたパスワードを含む認証 (Authinfo) ファイルを指定します。このオプションを使用すると、ツールを実行するたびにパスワードを再入力する手間を省くことができます。
  
  ツールを実行するたびに Authinfo ファイルを自動的に使用するには、ファイルに「_authinfo」(アンダースコアを含む) という名前を付け、Windows ホームディレクトリー (通常は C:\Users\<username>) に保存します。ファイルには、_authinfo.txt や _authinfo.netrc などの任意のファイル拡張子を付けることができます。このファイルがホームディレクトリーに存在する場合、CAS 認証 (Authinfo) ファイル パラメーターにそのファイルが自動的に設定されます。これにより、ツールを使用するたびに同じ Authinfo ファイルを参照する必要がなくなります。
  
  Authinfo ファイルには複数のホストとポートの接続情報を含めることができますが、1 人のユーザーが 1 つのホストとポートに接続する最もシンプルなケースでは、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 ホスト名 URL (オプション)	CAS ホストの URL。	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 (オプション)	CAS ホストの URL。	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 ウィンドウスクリプトは、ローカル SAS インストールでの TableToSAS 関数の使用方法を示しています。

import arcpy
arcpy.conversion.TableToSAS("MyData", "sasuser.MySASData", "OVERWRITE",
                            "USE_DOMAIN", "LOCAL_SAS")

TableToSAS の例 2 (スタンドアロンスクリプト)

次のスタンドアロン Python スクリプトは、CAS への接続を使用した 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: はい

テーブル → SAS (変換ツール)

サマリー

使用法

注意:

パラメーター

環境

ライセンス情報

関連トピック