ラベル | 説明 | データ タイプ |
入力テーブル | 入力テーブル。 | 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 ライブラリに保存するかを指定します。
| Boolean |
CAS ホスト名 URL (オプション) | CAS ホストの URL。 | String |
ポート (オプション) | CAS 接続のポート。 | Long |
CAS ユーザー名 (オプション) | CAS 接続のユーザー名。 | String |
パスワード (オプション) | CAS 接続のパスワード。 ツールの実行後にパスワードは非表示になるため、アクセスすることができません。 | String Hidden |
カスタム セッション構成ファイル (オプション) | SAS セッションのカスタム構成を指定するファイル。 このファイルは、SAS のカスタマイズされたローカル配置またはリモート配置の場合にのみ必要です。 | File |
CAS 認証 (Authinfo) ファイル (オプション) | CAS に接続する際の認証情報を含むファイル。 ファイルには、接続用のユーザー名と、エンコードされたパスワードが含まれる必要があります。 ファイルが指定されている場合、[CAS ユーザー名] パラメーターと [パスワード] パラメーターは指定する必要はありません。 | File |
サマリー
テーブルを SAS データセットに変換します。
使用法
このツールは、ローカル コンピューターにインストールされている SAS Desktop への接続または SAS Cloud Analytic Services (CAS) への接続に対応しています。 CAS を使用している場合は、変換中にレコードの順序が変更されることがあります。
Workspace Server、UNIX、Mainframe などの SAS のリモート配置の場合、[カスタム セッション構成ファイル] パラメーターを使用する必要があります。 SAS が、ArcGIS AllSource と同じコンピューターにインストールされている場合、構成ファイルは不要です。
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 を定義する必要があります。
CAS に接続する際、2 通りの方法で認証情報を認証できます。
- [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 プロシージャを使用し、ファイルのパスワードをエンコードできます。
WORK ライブラリは SAS セッションの開始時に作成される一時的なワークスペースで、セッションの終了時にすべてのファイルが削除されます。 このツールは操作中に新しい SAS セッションを開始および終了するため、このツール内で WORK ライブラリを使用しないでください。
パラメーター
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 データセットを上書きするかどうかを指定します。
| Boolean |
use_domain_and_subtype_description (オプション) | ドメインとサブタイプの説明を出力 SAS データセットに含めるかどうかを指定します。
| Boolean |
use_cas_connection (オプション) | 出力 SAS データセットを CAS にアップロードするか、ローカル 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 |
コードのサンプル
次の Python ウィンドウ スクリプトは、ローカル SAS インストールで TableToSAS 関数を使用する方法を示しています。
import arcpy
arcpy.conversion.TableToSAS("MyData", "sasuser.MySASData", "OVERWRITE",
"USE_DOMAIN", "LOCAL_SAS")
次のスタンドアロン 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())