テーブル → SAS (Table To SAS) (変換)—ArcGIS AllSource

サマリー

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

使用法

このツールは、ローカルコンピューターにインストールされている SAS Desktop への接続または SAS Cloud Analytic Services (CAS) への接続に対応しています。 CAS を使用している場合は、変換中にレコードの順序が変更されることがあります。
Workspace Server、UNIX、Mainframe などの SAS のリモート配置の場合、[カスタムセッション構成ファイル] パラメーターを使用する必要があります。 SAS が、ArcGIS AllSource と同じコンピューターにインストールされている場合、構成ファイルは不要です。
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 に接続する際、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 プロシージャを使用し、ファイルのパスワードをエンコードできます。
  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())

環境

このツールは、ジオプロセシング環境を使用しません。

サマリー

使用法

パラメーター

コードのサンプル

環境

関連トピック

このトピックの内容