Teradata への接続を追加

Teradata への接続を追加するには：

1. アプリケーションコンソールで、接続ページに移動します。
2. 接続の追加パネルで、追加したい接続のアイコンを選択します。
3. Teradata アイコンが利用できない場合は、Add More アイコンをクリックしてCData サイトからTeradata コネクタをダウンロードおよびインストールします。

必須プロパティについては、設定タブを参照してください。

通常必須ではない接続プロパティについては、高度な設定タブを参照してください。

Sync App は、公式のTeradata Database ドライバーをラップします。同じ接続プロパティを使用してCData Sync App に接続し、基底のTeradata ドライバーと同じ機能にアクセスできます。

接続の前に

Teradata への接続

必須プロパティ

Teradata に接続するには、次の認証情報を提供し、データベースサーバー名を指定します。

• AuthScheme：Teradata サーバーの必要な認証メカニズムに応じて、TD2（デフォルト）またはLDAP のいずれかに設定。
• User：Teradata ユーザーのユーザー名に設定。
• Password：Teradata ユーザーのパスワードに設定。
• DataSource：Teradata サーバー名、DBC 名、またはTDPID を指定。
• Port：サーバーが実行されているポートを指定。
• Database：データベース名を指定。指定されない場合は、Sync App はデフォルトデータベースに接続されます。

TLS/SSL 設定

このセクションでは、Teradata Sync App の高度な機能を厳選して説明します。

ファイアウォールとプロキシ

Windows プロキシを含むファイアウォールとプロキシ に合致するようSync App を設定します。トンネル接続を設定することもできます。

ログ

CData ログを調整するために使用可能な設定の概要については、ログ を参照してください。基本的なロギングでは、 次の2つの接続プロパティを設定するだけです。LogModules 接続プロパティを使用してログに記録する情報のサブセットを選択できる、 より洗練されたロギングをサポートする多数の機能があります。

Firewall またはProxy 経由の接続

次のプロパティを設定します。

• プロキシベースのファイヤーウォールを使用するには、FirewallType、FirewallServer、およびFirewallPort を設定します。
• 接続をトンネルするには、FirewallType をTUNNEL に設定します。
• 認証するには、FirewallUser とFirewallPassword を設定します。
• SOCKS プロキシへの認証には、さらにFirewallType をSOCKS5 に設定します。

接続文字列プロパティは、接続を確立するために使用できるさまざまなオプションです。このセクションでは、本プロバイダーの接続文字列で設定できるオプションの一覧を示します。詳細については各リンクをクリックしてください。

接続を確立する方法について詳しくは、接続の確立を参照してください。

Authentication

---

プロパティ	説明
DataSource	The Teradata server name or, equivalently, the DBC Name or TDPID.
AuthScheme	Specifies the Logon Mechanism, which determines the connection's authentication and encryption capabilities
User	認証で使用されるTeradata ユーザーアカウント。
Password	ユーザーの認証で使用されるパスワード。
Database	The database selected as the default database when a Teradata connection is opened.
Port	Connects to the Teradata Database on the TCP/IP port specified. The default Teradata Database port is 1025.
Account	Specifies an account string to override the default account string defined for the Teradata Database user.

Firewall

---

プロパティ	説明
FirewallType	プロキシベースのファイアウォールで使われるプロトコル。
FirewallServer	プロキシベースのファイアウォールの名前もしくはIP アドレス。
FirewallPort	プロキシベースのファイアウォールのTCP ポート。
FirewallUser	プロキシベースのファイアウォールに認証するために使うユーザー名。
FirewallPassword	プロキシベースのファイアウォールへの認証に使われるパスワード。

Logging

---

プロパティ	説明
LogModules	ログファイルに含めるコアモジュール。

Schema

---

プロパティ	説明
Location	テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリへのパス。
BrowsableSchemas	このプロパティは、使用可能なスキーマのサブセットにレポートされるスキーマを制限します。例えば、BrowsableSchemas=SchemaA,SchemaB,SchemaC です。
Tables	このプロパティは、使用可能なテーブルのサブセットにレポートされるテーブルを制限します。例えば、Tables=TableA,TableB,TableC です。
Views	使用可能なテーブルのサブセットにレポートされるビューを制限します。例えば、Views=ViewA,ViewB,ViewC です。

Miscellaneous

---

プロパティ	説明
DisableAutoCommitInBatch	Specifies whether or not disable the autocommit when executing the batch operation.
HttpsPort	Connects to the database on the Transmission Control Protocol/Internet Protocol (TCP/IP) port specified for HTTPS/TLS connections.
MaxRows	クエリで集計またはGROUP BY を使用しない場合に返される行数を制限します。これはLIMIT 句よりも優先されます。
Other	これらの隠しプロパティは特定のユースケースでのみ使用されます。
QueryPassthrough	このオプションは、クエリをTeradata サーバーにas-is で渡します。
SslCa	Specifies the file name of a PEM file that contains Certificate Authority (CA) certificates for use with SSLMODE=VERIFY-CA or VERIFY-FULL.
SslCaPath	Specifies a directory of PEM files that contain Certificate Authority (CA) certificates for use with SSLMODE=VERIFY-CA or VERIFY-FULL.
SslMode	Specifies the mode for connections to the database.
SslProtocol	Specifies the TLS protocol for HTTPS/TLS connections.
Timeout	タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。
UpperCaseIdentifiers	This property reports all identifiers in uppercase. This is the default for Oracle databases and thus allows better integration with Oracle tools such as the Oracle Database Gateway.
UseXViews	Specifies which Data Dictionary views should be queried to return result sets from DatabaseMetaData methods.

このセクションでは、本プロバイダーの接続文字列で設定可能なAuthentication プロパティの全リストを提供します。

---

プロパティ	説明
DataSource	The Teradata server name or, equivalently, the DBC Name or TDPID.
AuthScheme	Specifies the Logon Mechanism, which determines the connection's authentication and encryption capabilities
User	認証で使用されるTeradata ユーザーアカウント。
Password	ユーザーの認証で使用されるパスワード。
Database	The database selected as the default database when a Teradata connection is opened.
Port	Connects to the Teradata Database on the TCP/IP port specified. The default Teradata Database port is 1025.
Account	Specifies an account string to override the default account string defined for the Teradata Database user.

The Teradata server name or, equivalently, the DBC Name or TDPID.

解説

The Teradata server name or, equivalently, the DBC Name or TDPID.

Specifies the Logon Mechanism, which determines the connection's authentication and encryption capabilities

解説

Specifies the Logon Mechanism, which determines the connection's authentication and encryption capabilities

認証で使用されるTeradata ユーザーアカウント。

解説

このフィールドは、Password とともに、Teradata サーバーに対して認証をするために使われます。

ユーザーの認証で使用されるパスワード。

解説

User およびPassword を一緒に使用してサーバーで認証を行います。

The database selected as the default database when a Teradata connection is opened.

解説

The database selected as the default database when a Teradata connection is opened.

Connects to the Teradata Database on the TCP/IP port specified. The default Teradata Database port is 1025.

解説

Connects to the Teradata Database on the TCP/IP port specified. The default Teradata Database port is 1025.

Specifies an account string to override the default account string defined for the Teradata Database user.

解説

Specifies an account string to override the default account string defined for the Teradata Database user. Accounts are used by the Teradata Database for workload management and resource usage monitoring.

このセクションでは、本プロバイダーの接続文字列で設定可能なFirewall プロパティの全リストを提供します。

---

プロパティ	説明
FirewallType	プロキシベースのファイアウォールで使われるプロトコル。
FirewallServer	プロキシベースのファイアウォールの名前もしくはIP アドレス。
FirewallPort	プロキシベースのファイアウォールのTCP ポート。
FirewallUser	プロキシベースのファイアウォールに認証するために使うユーザー名。
FirewallPassword	プロキシベースのファイアウォールへの認証に使われるパスワード。

プロキシベースのファイアウォールで使われるプロトコル。

解説

このプロパティは、Sync App がFirewallServer プロキシ経由でトンネルトラフィックを使うためのプロトコルを指定します。

タイプ	デフォルトポート	説明
TUNNEL	80	これが設定されている場合、Sync App はTeradata への接続を開き、プロキシを経由して通信が行われます。
SOCKS4	1080	これが設定されている場合、Sync App はデータをFirewallServer およびFirewallPort で指定されたSOCS 4 プロキシ経由で送信し、接続リクエストが許容されるかどうかを決定します。
SOCKS5	1080	これが設定されている場合、Sync App はデータをFirewallServer およびFirewallPort で指定されたSOCS 5 プロキシ経由で送信します。プロキシに認証が必要な場合には、FirewallUser およびFirewallPassword をプロキシが認識する認証情報に設定します。

プロキシベースのファイアウォールの名前もしくはIP アドレス。

解説

ファイアウォールトラバーサルを許容するために設定するIP アドレス、DNS 名、もしくはプロキシホスト名を指定するプロパティです。プロトコルはFirewallType で指定されます。このプロパティとFirewallServer を使って、SOCKS 経由での接続、もしくはトンネリングが可能です。

プロキシベースのファイアウォールのTCP ポート。

解説

ファイアウォールトラバーサルを許容するために設定するプロキシベースのファイアウォールのTCP ポート。名前もしくはIP アドレスを指定するには、FirewallServer を使います。FirewallType でプロトコルを指定します。

プロキシベースのファイアウォールに認証するために使うユーザー名。

解説

FirewallUser およびFirewallPassword プロパティは、FirewallType により指定された認証方式に則り、FirewallServer、およびFirewallPort で指定されたプロキシに対しての認証に使われます。

プロキシベースのファイアウォールへの認証に使われるパスワード。

解説

このプロパティは、FirewallType により指定された認証メソッドに則り、FirewallServer およびFirewallPort で指定されたプロキシに渡されます。

このセクションでは、本プロバイダーの接続文字列で設定可能なLogging プロパティの全リストを提供します。

---

プロパティ	説明
LogModules	ログファイルに含めるコアモジュール。

ログファイルに含めるコアモジュール。

解説

指定された（';' で区切られた）モジュールのみがログファイルに含まれます。デフォルトではすべてのモジュールが含まれます。

概要はログ ページを参照してください。

このセクションでは、本プロバイダーの接続文字列で設定可能なSchema プロパティの全リストを提供します。

---

プロパティ	説明
Location	テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリへのパス。
BrowsableSchemas	このプロパティは、使用可能なスキーマのサブセットにレポートされるスキーマを制限します。例えば、BrowsableSchemas=SchemaA,SchemaB,SchemaC です。
Tables	このプロパティは、使用可能なテーブルのサブセットにレポートされるテーブルを制限します。例えば、Tables=TableA,TableB,TableC です。
Views	使用可能なテーブルのサブセットにレポートされるビューを制限します。例えば、Views=ViewA,ViewB,ViewC です。

テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリへのパス。

解説

Sync App のスキーマファイル（テーブルとビューの場合は.rsd ファイル、ストアドプロシージャの場合は.rsb ファイル）を含むディレクトリへのパス。このフォルダの場所は、実行ファイルの場所からの相対パスにすることができます。Location プロパティは、定義をカスタマイズしたり（例えば、カラム名を変更する、カラムを無視するなど）、新しいテーブル、ビュー、またはストアドプロシージャでデータモデルを拡張する場合にのみ必要です。

指定しない場合、デフォルトの場所は"%APPDATA%\\CData\\Teradata Data Provider\\Schema" となり、%APPDATA% はユーザーのコンフィギュレーションディレクトリに設定されます：

Platform	%APPDATA%
Windows	APPDATA 環境変数の値
Linux	~/.config

このプロパティは、使用可能なスキーマのサブセットにレポートされるスキーマを制限します。例えば、BrowsableSchemas=SchemaA,SchemaB,SchemaC です。

解説

スキーマをデータベースからリストすると、負荷がかかる可能性があります。接続文字列でスキーマのリストを提供すると、 パフォーマンスが向上します。

このプロパティは、使用可能なテーブルのサブセットにレポートされるテーブルを制限します。例えば、Tables=TableA,TableB,TableC です。

解説

テーブルを複数のデータベースからリストすると、負荷がかかる可能性があります。接続文字列でテーブルのリストを提供すると、Sync App のパフォーマンスが向上します。

このプロパティは、作業したいビューがすでにわかっていて、ビューが多すぎる場合に、ビューを自動的にリストする代わりに使用することもできます。

カンマ区切りのリストで使用したいテーブルを指定します。各テーブルは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。 例えば、Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space` です。

複数のスキーマまたはカタログを持つデータソースに接続する場合は、複数のカタログやスキーマに存在するテーブル間の曖昧さを避けるため、最後の例のように、このプロパティにテーブルの完全修飾名を指定する必要があることに注意してください。

使用可能なテーブルのサブセットにレポートされるビューを制限します。例えば、Views=ViewA,ViewB,ViewC です。

解説

ビューを複数のデータベースからリストすると、負荷がかかる可能性があります。接続文字列でビューのリストを提供すると、Sync App のパフォーマンスが向上します。

このプロパティは、作業したいビューがすでにわかっていて、ビューが多すぎる場合に、ビューを自動的にリストする代わりに使用することもできます。

カンマ区切りのリストで使用したいビューを指定します。各ビューは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。 例えば、Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space` です。

複数のスキーマまたはカタログを持つデータソースに接続する場合は、複数のカタログやスキーマに存在するテーブル間の曖昧さを避けるため、最後の例のように、このプロパティにテーブルの完全修飾名を指定する必要があることに注意してください。

このセクションでは、本プロバイダーの接続文字列で設定可能なMiscellaneous プロパティの全リストを提供します。

---

プロパティ	説明
DisableAutoCommitInBatch	Specifies whether or not disable the autocommit when executing the batch operation.
HttpsPort	Connects to the database on the Transmission Control Protocol/Internet Protocol (TCP/IP) port specified for HTTPS/TLS connections.
MaxRows	クエリで集計またはGROUP BY を使用しない場合に返される行数を制限します。これはLIMIT 句よりも優先されます。
Other	これらの隠しプロパティは特定のユースケースでのみ使用されます。
QueryPassthrough	このオプションは、クエリをTeradata サーバーにas-is で渡します。
SslCa	Specifies the file name of a PEM file that contains Certificate Authority (CA) certificates for use with SSLMODE=VERIFY-CA or VERIFY-FULL.
SslCaPath	Specifies a directory of PEM files that contain Certificate Authority (CA) certificates for use with SSLMODE=VERIFY-CA or VERIFY-FULL.
SslMode	Specifies the mode for connections to the database.
SslProtocol	Specifies the TLS protocol for HTTPS/TLS connections.
Timeout	タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。
UpperCaseIdentifiers	This property reports all identifiers in uppercase. This is the default for Oracle databases and thus allows better integration with Oracle tools such as the Oracle Database Gateway.
UseXViews	Specifies which Data Dictionary views should be queried to return result sets from DatabaseMetaData methods.

Specifies whether or not disable the autocommit when executing the batch operation.

解説

Specifies whether or not disable the autocommit when executing the batch operation.

Connects to the database on the Transmission Control Protocol/Internet Protocol (TCP/IP) port specified for HTTPS/TLS connections.

解説

The default port is 443 for HTTPS/TLS connections to the database. HTTPS/TLS connections are available with Teradata JDBC Driver 17.10.00.07 and later, with Teradata Advanced SQL Engine 17.10 and later, or Teradata Advanced SQL Engine 16.20.53.30 and later.

クエリで集計またはGROUP BY を使用しない場合に返される行数を制限します。これはLIMIT 句よりも優先されます。

解説

クエリで集計またはGROUP BY を使用しない場合に返される行数を制限します。これはLIMIT 句よりも優先されます。

これらの隠しプロパティは特定のユースケースでのみ使用されます。

解説

以下にリストされているプロパティは、特定のユースケースで使用可能です。通常のドライバーのユースケースおよび機能では、これらのプロパティは必要ありません。

複数のプロパティをセミコロン区切りリストで指定します。

統合およびフォーマット

DefaultColumnSize	データソースがメタデータにカラムの長さを提供しない場合に、文字列フィールドのデフォルトの長さを設定します。デフォルト値は2000です。
ConvertDateTimeToGMT	日時の値を、マシンのローカルタイムではなくGMT グリニッジ標準時に変換するかどうかを決定します。
RecordToFile=filename	基底のソケットデータ転送を指定のファイルに記録します。

このオプションは、クエリをTeradata サーバーにas-is で渡します。

解説

これが設定されていると、クエリはTeradata に直接渡されます。

Specifies the file name of a PEM file that contains Certificate Authority (CA) certificates for use with SSLMODE=VERIFY-CA or VERIFY-FULL.

解説

Specifies the file name of a PEM file that contains Certificate Authority (CA) certificates for use with SSLMODE=VERIFY-CA or VERIFY-FULL. HTTPS/TLS connections are available with Teradata JDBC Driver 17.10.00.07 and later, with Teradata Advanced SQL Engine 17.10 and later, or Teradata Advanced SQL Engine 16.20.53.30 and later.

Specifies a directory of PEM files that contain Certificate Authority (CA) certificates for use with SSLMODE=VERIFY-CA or VERIFY-FULL.

解説

Specifies a directory of PEM files that contain Certificate Authority (CA) certificates for use with SSLMODE=VERIFY-CA or VERIFY-FULL. Only files with an extension of .pem are used. Other files in the specified directory are not used. HTTPS/TLS connections are available with Teradata JDBC Driver 17.10.00.07 and later, with Teradata Advanced SQL Engine 17.10 and later, or Teradata Advanced SQL Engine 16.20.53.30 and later.

Specifies the mode for connections to the database.

解説

Specifies the mode for connections to the database. HTTPS/TLS connections are available with Teradata JDBC Driver 17.10.00.07 and later, with Teradata Advanced SQL Engine 17.10 and later, or Teradata Advanced SQL Engine 16.20.53.30 and later.

Specifies the TLS protocol for HTTPS/TLS connections.

解説

Specifies the TLS protocol for HTTPS/TLS connections. HTTPS/TLS connections are available with Teradata JDBC Driver 17.10.00.07 and later, with Teradata Advanced SQL Engine 17.10 and later, or Teradata Advanced SQL Engine 16.20.53.30 and later.

タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。

解説

Timeout が0に設定されている場合は、操作がタイムアウトしません。処理が正常に完了するか、エラー状態になるまで実行されます。

Timeout の有効期限が切れても処理が完了していない場合は、Sync App は例外をスローします。

This property reports all identifiers in uppercase. This is the default for Oracle databases and thus allows better integration with Oracle tools such as the Oracle Database Gateway.

解説

Set this property to report all identifiers, including table and column names, in uppercase. This is the default for Oracle databases and thus allows better integration with Oracle tools such as the Oracle Database Gateway. For example, you can use this property to avoid quoting identifiers.

Specifies which Data Dictionary views should be queried to return result sets from DatabaseMetaData methods.

解説

Specifies which Data Dictionary views should be queried to return result sets from DatabaseMetaData methods. When the user does not specify the property, the driver creates the connection. The official driver uses the default value.