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 データセットの列の形式は出力テーブルで保持されません。
ローカルの 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 ライブラリーを使用しないでください。

ラベル	説明	データタイプ
入力 SAS データセット (libref.tablename)	入力 SAS データセット。 `libref.tablename` の形式でデータセットを指定します。ここで、`libref` は SAS ライブラリーの名前を表し、`tablename` は SAS データセットの名前を表します。	String
出力テーブル	出力テーブル。	Table
SAS データセットを SAS Cloud Analytic Services (CAS) からダウンロード (オプション)	入力 SAS データセットを CAS からダウンロードするか、入力 SAS データセットにローカル 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.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 データセットにローカル 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

コードのサンプル

SASToTable の例 1 (Python ウィンドウ)

次の Python ウィンドウスクリプトは、ローカル SAS インストールでの SASToTable 関数の使用方法を示しています。

import arcpy
arcpy.conversion.SASToTable("sashelp.cars", "CarsTable", "LOCAL_SAS")

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

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

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

サマリー

使用法

注意:

パラメーター

環境

ライセンス情報

関連トピック