接続リファレンス PowerBuilder®

by user

on 28 марта 2017

Category: Documents

>> Downloads: 31

230

views

Report

Comments

Description

Download 接続リファレンス PowerBuilder®

Transcript

接続リファレンス PowerBuilder®

接続リファレンス
PowerBuilder®
10.2.1 C2
DOCUMENT ID: DC33820-01-1021C2-01
LAST REVISED: July 2007
Copyright © 1991-2007 by Sybase, Inc. All rights reserved.
本書に記載されているソフトウェアは、 Sybase ライセンス契約に基づいて Sybase, Inc. が提供し、かかる契約の条項に従う
場合にのみ使用が許諾されます。
本書に記載されている内容は、 Sybase, Inc. およびその関連会社の書面による許可なく、いかなる形態、または手段、電子
的、機械的、手作業、光学的およびその他にかかわらず、複製、転載および翻訳を禁じます。
Sybase, Sybase （ロゴ） , AccelaTrade, ADA Workbench, Adaptable Windowing Environment, Adaptive Component Architecture,
Adaptive Server, Adaptive Server Anywhere, Adaptive Server Enterprise, Adaptive Server Enterprise Monitor, Adaptive Server
Enterprise Replication, Adaptive Server Everywhere, Adaptive Server IQ, Adaptive Warehouse, Anywhere Studio, Application
Manager, AppModeler, APT Workbench, APT-Build, APT-Edit, APT-Execute, APT-Translator, APT-Library, AvantGo, AvantGo
Application Alerts, AvantGo Mobile Delivery, AvantGo Mobile Document Viewer, AvantGo Mobile Inspection, AvantGo Mobile
Marketing Channel, AvantGo Mobile Pharma, AvantGo Mobile Sales, AvantGo Pylon, AvantGo Pylon Application Server, AvantGo
Pylon Conduit, AvantGo Pylon PIM Server, AvantGo Pylon Pro, Backup Server, BizTracker, ClearConnect, Client-Library, Client
Services, Convoy/DM, Copernicus, Data Pipeline, Data Workbench, DataArchitect, Database Analyzer, DataExpress, DataServer,
DataWindow, DB-Library, dbQueue, Developers Workbench, Direct Connect Anywhere, DirectConnect, Distribution Director, e-ADK,
E-Anywhere, e-Biz Impact, e-Biz Integrator, E-Whatever, EC Gateway, ECMAP, ECRTP, eFulfillment Accelerator, Embedded SQL,
EMS, Enterprise Application Studio, Enterprise Client/Server, Enterprise Connect, Enterprise Data Studio, Enterprise Manager,
Enterprise SQL Server Manager, Enterprise Work Architecture, Enterprise Work Designer, Enterprise Work Modeler, eProcurement
Accelerator, EWA, Financial Fusion, Financial Fusion Server, Gateway Manager, GlobalFIX, iAnywhere, ImpactNow, Industry
Warehouse Studio, InfoMaker, Information Anywhere, Information Everywhere, InformationConnect, InternetBuilder, iScript, Jaguar
CTS, jConnect for JDBC, Mail Anywhere Studio, MainframeConnect, Maintenance Express, Manage Anywhere Studio, M-Business
Channel, M-Business Network, M-Business Server, MDI Access Server, MDI Database Gateway, media.splash, MetaWorks, My
AvantGo, My AvantGo Media Channel, My AvantGo Mobile Marketing, MySupport, Net-Gateway, Net-Library, New Era of Networks,
ObjectConnect, ObjectCycle, OmniConnect, OmniSQL Access Module, OmniSQL Toolkit, Open Biz, Open Client, Open
ClientConnect, Open Client/Server, Open Client/Server Interfaces, Open Gateway, Open Server, Open ServerConnect, Open Solutions,
Optima++, Orchestration Studio, PB-Gen, PC APT Execute, PC DB-Net, PC Net Library, PocketBuilder, Pocket PowerBuilder,
Power++, power.stop, PowerAMC, PowerBuilder, PowerBuilder Foundation Class Library, PowerDesigner, PowerDimensions,
PowerDynamo, PowerJ, PowerScript, PowerSite, PowerSocket, Powersoft, PowerStage, PowerStudio, PowerTips, Powersoft Portfolio,
Powersoft Professional, PowerWare Desktop, PowerWare Enterprise, ProcessAnalyst, Rapport, RepConnector, Replication Agent,
Replication Driver, Replication Server, Replication Server Manager, Replication Toolkit, Report-Execute, Report Workbench, Resource
Manager, RW-DisplayLib, RW-Library, S-Designor, SDF, Secure SQL Server, Secure SQL Toolset, Security Guardian, SKILS,
smart.partners, smart.parts, smart.script, SQL Advantage, SQL Anywhere, SQL Anywhere Studio, SQL Code Checker, SQL Debug,
SQL Edit, SQL Edit/TPU, SQL Everywhere, SQL Modeler, SQL Remote, SQL Server, SQL Server Manager, SQL SMART, SQL
Toolset, SQL Server/CFT, SQL Server/DBM, SQL Server SNMP SubAgent, SQL Station, SQLJ, STEP, SupportNow, S.W.I.F.T.
Message Format Libraries, Sybase Central, Sybase Client/Server Interfaces, Sybase Financial Server, Sybase Gateways, Sybase MPP,
Sybase SQL Desktop, Sybase SQL Lifecycle, Sybase SQL Workgroup, Sybase User Workbench, SybaseWare, Syber Financial,
SyberAssist, SyBooks, System 10, System 11, System XI （ロゴ） , SystemTools, Tabular Data Stream, TotalFix, TradeForce, TransactSQL, Translation Toolkit, UltraLite, UltraLite.NET, UNIBOM, Unilib, Uninull, Unisep, Unistring, URK Runtime Kit for UniCode,
VisualWriter, VQL, WarehouseArchitect, Warehouse Control Center, Warehouse Studio, Warehouse WORKS, Watcom, Watcom SQL,
Watcom SQL Server, Web Deployment Kit, Web.PB, Web.SQL, WebSights, WebViewer, WorkGroup SQL Server, XA-Library, XAServer および XP Server は Sybase, Inc. の登録商標です。
Unicode および Unicode のロゴは Unicode, Inc. の登録商標です。
本書で使用される会社名および製品名はそれぞれの会社の商標および登録商標です。
本書に記載されている内容は、将来予告なしに変更することがあります。また、本ソフトウェアおよび説明書を使用した
ことによる損害、または第三者からのいかなる請求についても、サイベース株式会社、その親会社である米国法人 Sybase,
Inc. またはその関連会社は、一切の責任を負わないものとします。
目次
本書について ................................................................................................................................. vii
第1章
接続リファレンス
データベースパラメータの解説 ........................................................................... 1
データベースパラメータとサポートされているデータベースインタ
フェース ............................................................................. 1
AppName .................................................................................. 6
Async......................................................................................... 7
BindSPInput .............................................................................. 9
BinTxtBlob ............................................................................... 10
Block （ODBC、 OLE DB、 Oracle） ......................................... 11
Block （Adaptive Server Enterprise） ....................................... 14
CacheAuthentication ............................................................... 15
CacheName ............................................................................ 16
CallEscape .............................................................................. 17
CharSet ................................................................................... 18
CnnPool................................................................................... 19
CommandTimeout ................................................................... 21
CommitOnDisconnect ............................................................. 21
ConnectAs............................................................................... 23
ConnectOption ........................................................................ 24
ConnectString.......................................................................... 29
CursorLib................................................................................. 31
CursorLock .............................................................................. 31
CursorScroll............................................................................. 33
CursorUpdate .......................................................................... 34
Database ................................................................................. 35
DataLink .................................................................................. 36
DataSource ............................................................................. 37
Date......................................................................................... 38
DateFormat ............................................................................. 40
DateTime................................................................................. 42
DateTimeAllowed .................................................................... 44
DateTimeFormat ..................................................................... 46
DBGetTime.............................................................................. 47
iii
目次
DBTextLimit............................................................................. 48
DecimalSeparator.................................................................... 49
DefaultProcOwner ................................................................... 51
DelimitIdentifier........................................................................ 52
DisableBind ............................................................................. 53
DisableUnicode ....................................................................... 57
Driver....................................................................................... 58
DS_Alias.................................................................................. 59
DS_Copy ................................................................................. 61
DS_DitBase............................................................................. 64
DS_Failover............................................................................. 68
DS_Password.......................................................................... 70
DS_Principal............................................................................ 72
DS_Provider ............................................................................ 74
DS_TimeLimit.......................................................................... 76
EncryptPassword .................................................................... 77
FoDelay ................................................................................... 78
FoDialog .................................................................................. 79
FoRetryCount .......................................................................... 80
FormatArgsAsExp ................................................................... 81
GetConnectionOption.............................................................. 82
Host ......................................................................................... 84
IdentifierQuoteChar ................................................................. 86
ImpersonationLevel ................................................................. 88
INET_DBPATH........................................................................ 89
INET_PROTOCOL .................................................................. 90
INET_SERVICE ...................................................................... 91
Init_Prompt .............................................................................. 92
InsertBlock............................................................................... 93
IntegratedSecurity ................................................................... 95
Isolation ................................................................................... 96
JavaVM ................................................................................... 97
KeepAlive ................................................................................ 98
Language ................................................................................ 99
LCID ...................................................................................... 100
Locale.................................................................................... 101
Location................................................................................. 102
Log ........................................................................................ 103
LoginTimeOut........................................................................ 104
MapDateToDateTime ............................................................ 104
MaskPassword ...................................................................... 105
MaxConnect .......................................................................... 106
MaxFetchBuffer ..................................................................... 107
MixedCase ............................................................................ 108
iv
PowerBuilder
目次
Mode .....................................................................................
MsgTerse ..............................................................................
Namespace ...........................................................................
NCharBind.............................................................................
NLS_Charset.........................................................................
NumbersInternal....................................................................
NumericFormat......................................................................
ObjectMode ...........................................................................
ODBCU_CONLIB ..................................................................
OJSyntax...............................................................................
OraMTSConFlgs ...................................................................
PackageProcs .......................................................................
PacketSize （ODBC）.............................................................
PacketSize （SYC）................................................................
PBCatalogOwner...................................................................
PBMaxBlobSize.....................................................................
PBNewSPInvocation .............................................................
PBNoCatalog.........................................................................
PBTrimCharColumns ............................................................
PBUseProcOwner .................................................................
PersistEncrypted ...................................................................
PersistSensitive.....................................................................
Properties ..............................................................................
ProtectionLevel......................................................................
Provider .................................................................................
ProviderString........................................................................
ProxyUserName ....................................................................
PWDialog ..............................................................................
PWEncrypt ............................................................................
PWExpDialog ........................................................................
QualifyPublic .........................................................................
RecheckRows .......................................................................
Release .................................................................................
ReleaseConnectionOption ....................................................
RPCRebind ...........................................................................
ReturnCommandHandle........................................................
Scroll .....................................................................................
Sec_Channel_Bind................................................................
Sec_Confidential ...................................................................
Sec_Cred_Timeout ...............................................................
Sec_Data_Integrity................................................................
Sec_Data_Origin ...................................................................
Sec_Delegation .....................................................................
Sec_Keytab_File ...................................................................
接続リファレンス
109
110
111
112
114
115
116
119
120
121
123
125
126
127
128
131
132
133
134
135
137
138
139
140
141
142
143
144
146
147
148
149
150
153
155
156
157
158
160
162
163
165
167
169
v
目次
Sec_Mechanism....................................................................
Sec_Mutual_Auth ..................................................................
Sec_Network_Auth................................................................
Sec_Replay_Detection..........................................................
Sec_Seq_Detection...............................................................
Sec_Server_Principal............................................................
Sec_Sess_Timeout ...............................................................
ServiceComponents ..............................................................
ShowTempTables .................................................................
SQLCache.............................................................................
StaticBind ..............................................................................
StrByCharset .........................................................................
StripParmNames ...................................................................
SvrFailover ............................................................................
SystemProcs .........................................................................
TableCriteria..........................................................................
ThreadSafe............................................................................
Time ......................................................................................
TimeFormat ...........................................................................
TimeOut.................................................................................
TimeStamp ............................................................................
TraceFile ...............................................................................
TrimSpaces ...........................................................................
TrustedConnection ................................................................
URL .......................................................................................
UseContextObject .................................................................
UTF8 .....................................................................................
第2章
171
174
175
178
180
182
184
186
187
188
190
192
193
194
196
197
198
200
202
204
204
206
207
208
209
211
213
データベース環境設定項目 ................................................................................. 215
データベース環境設定項目とサポートされているデータベースイン
タフェース...................................................................... 215
AutoCommit （自動コミットモード）.................................... 217
デフォルトのプロファイルに接続 ........................................ 220
DB の接続を保持................................................................... 221
LOCK （分離レベル） ............................................................. 222
読み込みのみ......................................................................... 226
共有 DB プロファイル........................................................... 227
SQL 構文の終止符................................................................. 228
拡張属性の使用 ..................................................................... 229
索引 ............................................................................................................................................. 231
vi
PowerBuilder
本書について
対象とする読者
このマニュアルは、 PowerBuilder® を使ってデータベースに接続す
る開発者やエンドユーザを対象に書かれています。読者が使用す
るデータベースに詳しく、また、接続に必要なサーバやクライア
ントのソフトウェアがすでにインストールされているものとして
書かれています。
目的
このマニュアルでは、 PowerBuilder からデータベースに接続する
ために使用するデータベースパラメータとデータベース環境設定
項目について説明しています。
関連資料
PowerBuilder 開発環境でデータベースに接続する方法の詳細につ
いては、『データベースとの接続』マニュアルを参照してください。
PowerBuilder のすべてのマニュアルの一覧については、『入門』マ
ニュアルを参照してください。
そのほかの情報
製品に関するそのほかの詳細情報については、 Sybase のテクニカ
ルライブラリ CD、およびテクニカルライブラリ製品マニュアル
Web サイト（英語）を参照してください。
•
ソフトウェア付属のテクニカルライブラリ CD には、製品マ
ニュアルが収められています。製品マニュアルは、PDF 形式に
て提供しています。
テクニカルライブラリ CD の使い方については、テクニカル
ライブラリ CD 内の Readme.txt ファイルを参照してください。
•
テクニカルライブラリ製品マニュアルの Web サイト（英語）に
は、 Product Manuals のサイト http://www.sybase.com/support/manuals/
からアクセスできます。
サポートについて
製品に同梱している「サポートハンドブック」を参照してくださ
い。
接続リファレンス
vii
本書について
viii
PowerBuilder
第 1 章
データベースパラメータの解説
この章について
この章では、 PowerBuilder において設定できる各データベースパ
ラメータの構文と使用方法について解説します。
コードでのデータベースパラメータの設定
DB 接続プロファイルダイアログボックスの［プレビュー］ペー
ジで、コードに正しい構文を使用していることを確認してくださ
い。多くのブール値のデータベースパラメータは、 TRUE、 Yes、
1 のいずれかを使用してオンにできます。また、 FALSE、 No、 0 を
使用してオフにできます。データベースパラメータに設定する数
値は引用符で囲わないでください。
データベースパラメータとサポートされているデータ
ベースインタフェース
次の表に、サポートされているデータベースインタフェースと、
PowerBuilder においてそのインタフェースで使用できるデータ
ベースパラメータを示します。
データベースパラメータは、次の表でアルファベット順に解説さ
れています。
接続リファレンス
1
データベースパラメータとサポートされているデータベースインタフェース
データベースインタフェース
ADO.NET
IN9 Informix
JDBC
2
DBParm パラメータ
CommandTimeout
CommitOnDisconnect
Database
DataLink
DataSource
DateFormat
DateTimeFormat
DecimalSeparator
DefaultProcOwner
DelimitIdentifier
DisableBind
IdentifierQuoteChar
Isolation
Namespace
NCharBind （O90 以降）
OJSyntax
PBCatalogOwner
PBMaxBlobSize
Provider
ProviderString
RecheckRows
StaticBind
TimeFormat
TimeOut
TrimSpaces
TrustedConnection
Async
BinTxtBlob
CommitOnDisconnect
DateTimeAllowed
DBGetTime
DecimalSeparator
DelimitIdentifier
DisableBind
INET_DBPATH
INET_PROTOCOL
INET_SERVICE
OJSyntax
Scroll
ThreadSafe
Async
CacheName
CommitOnDisconnect
Date
DateTime
DBGetTime
DelimitIdentifier
DisableBind
Driver
FormatArgsAsExp
GetConnectionOption
IdentifierQuoteChar
JavaVM （JDB のみ）
LoginTimeOut
MapDateToDateTime
MsgTerse
NumericFormat
OJSyntax
PBCatalogOwner
Properties
ProxyUserName
ReleaseConnectionOption
StaticBind
TableCriteria
Time
TraceFile
TrimSpaces
URL
UseContextObject
TrimSpaces
PowerBuilder
第1章
データベースパラメータの解説
データベースインタフェース
ODBC
DBParm パラメータ
Async
Block （ODBC、 OLE DB、 Oracle）
CacheName
ODBC での DBParms の使用
CallEscape
右に示したデータベースパラ
CommitOnDisconnect
メータは、使用する ODBC ドラ
ConnectOption
イバとバックエンド DBMS の
ConnectString
両方がこの機能をサポートして
CursorLib
いる場合にのみ、 PowerBuilder
CursorLock
ODBC インタフェースによって
CursorScroll
サポートされます。
Date
DateTime
DBGetTime
DecimalSeparator
DefaultProcOwner
DelimitIdentifier
DisableBind
FormatArgsAsExp
GetConnectionOption
OLE DB
接続リファレンス
BinTxtBlob
Block （ODBC、 OLE DB、 Oracle）
CacheAuthentication
CommitOnDisconnect
DataLink
DataSource
DateFormat
DateTimeFormat
DecimalSeparator
DelimitIdentifier
DisableBind
EncryptPassword
IdentifierQuoteChar
ImpersonationLevel
Init_Prompt
IntegratedSecurity
LCID
IdentifierQuoteChar
InsertBlock
LoginTimeOut
MsgTerse
NumericFormat
ODBCU_CONLIB
OJSyntax
PacketSize （ODBC）
PBCatalogOwner
PBNewSPInvocation
PBTrimCharColumns
PBUseProcOwner
ProxyUserName
ReleaseConnectionOption
RPCRebind
SQLCache
StaticBind
StripParmNames
TableCriteria
Time
TrimSpaces
UseContextObject
Location
MaskPassword
Mode
OJSyntax
PBCatalogOwner
PBMaxBlobSize
PBTrimCharColumns
PersistEncrypted
PersistSensitive
ProtectionLevel
Provider
ProviderString
RecheckRows
ReturnCommandHandle
ServiceComponents
StaticBind
TimeFormat
TimeOut
3
データベースパラメータとサポートされているデータベースインタフェース
データベースインタフェース
Oracle8i
O90 Oracle9i
O10 Oracle 10g
4
DBParm パラメータ
Async
BindSPInput
BinTxtBlob
Block （ODBC、 OLE DB、 Oracle）
CacheName
CnnPool （O90 以降）
CommitOnDisconnect
ConnectAs （O90 以降）
Date
DateTime
DBGetTime
DecimalSeparator
DelimitIdentifier
DisableBind
DisableUnicode （O84 のみ）
FoDelay
FoDialog
FoRetryCount
FormatArgsAsExp
GetConnectionOption
MaxFetchBuffer
MixedCase
NCharBind （O90 以降）
NLS_Charset （O90 以降）
NumbersInternal
ObjectMode
OJSyntax
OraMTSConFlgs
PackageProcs
PBCatalogOwner
PBNoCatalog
PWDialog
PWExpDialog
QualifyPublic
ReleaseConnectionOption
SQLCache
StaticBind
StrByCharset （O90 以降）
SvrFailover
TableCriteria
ThreadSafe
Time
TimeStamp （O90 以降）
UseContextObject
PowerBuilder
第1章
データベースパラメータの解説
データベースインタフェース
DBParm パラメータ
SYC Sybase Adaptive Server®
AppName
Enterprise
Async
BinTxtBlob
Block （Adaptive Server Enterprise）
Release の設定
CharSet
DS_* および Sec_* パラメータ
CommitOnDisconnect
を使用するには、 Release デー
CursorUpdate
タベースパラメータを Open
DateTimeAllowed
Client® ソフトウェアのバー
DBGetTime
ジョン（11 またはそれ以上）に
DBTextLimit
設定する必要があります。
DelimitIdentifier
DS_Alias
DS_Copy
DS_DitBase
DS_Failover
DS_Password
DS_Principal
DS_Provider
DS_TimeLimit
FoDialog
FormatArgsAsExp
Host
KeepAlive
Language
Locale
Log
MaxConnect
SYJ Sybase Adaptive Server
Enterprise
接続リファレンス
Block （Adaptive Server Enterprise）
CacheName
CursorUpdate
DBTextLimit
FormatArgsAsExp
GetConnectionOption
Log
PBCatalogOwner
OJSyntax
PacketSize （SYC）
PBCatalogOwner
ProxyUserName
PWDialog
PWEncrypt
PWExpDialog
Release
Sec_Channel_Bind
Sec_Confidential
Sec_Cred_Timeout
Sec_Data_Integrity
Sec_Data_Origin
Sec_Delegation
Sec_Keytab_File
Sec_Mechanism
Sec_Mutual_Auth
Sec_Network_Auth
Sec_Replay_Detection
Sec_Seq_Detection
Sec_Server_Principal
Sec_Sess_Timeout
ShowTempTables
StaticBind
SvrFailover
SystemProcs
TableCriteria
TrimSpaces
UTF8
ProxyUserName
ReleaseConnectionOption
StaticBind
SvrFailover
SystemProcs
TrimSpaces
UseContextObject
UTF8
5
AppName
AppName
機能
PowerBuilder からデータベースに接続するときに、使用するアプリ
ケーションの名前を指定します。ただし、 DBMS がこれをサポートし
ている場合に限ります。
AppName を指定するタイミング
AppName パラメータは、データベースに接続する前に指定します。
対象
SYC Sybase Adaptive Server Enterprise
構文
AppName = 'application_name'
デフォルト値
CS_APPNAME 接続プロパティに PowerBuilder が設定されます。
AppName = 'PowerBuilder'
解説
Adaptive Server データベース Adaptive Server アプリケーションごと
に異なる AppName 値を指定すると効果的です。管理者は、
MASTER.DBO.SYSPROCESSES テーブルを調べることによって、
データベースサーバ上でどのようなアプリケーションが稼働してい
るのかを判断できます。 AppName パラメータに指定する値は、
MASTER.DBO.SYSPROCESSES テーブルの program_name カラムに表
示されるため、アプリケーションを簡単に識別できます。
例
例1
•
アプリケーション名を Test に設定するには以下のようにします。
DB プロファイル設定ダイアログボッ
クスの［ネットワーク］タブの［アプリケーション名］ボックス
で、以下の入力を行います。
データベースプロファイル
Test
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "AppName='Test'"
例 2 1 つのステートメントに AppName パラメータと Host パラメータ
を指定することによって、アプリケーション名とホスト名の両方が指
定できます。アプリケーション名を Sales に、ホスト名を Fran に設定
するには以下のようにします。
DB プロファイル設定ダイアログボッ
クスの［ネットワーク］タブで、［アプリケーション名］ボックス
に Sales、［ワークステーション名］ボックスに Fran と入力します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "AppName='Sales',Host='Fran'"
6
PowerBuilder
第1章
関連項目
データベースパラメータの解説
Host （現在 SYC Sybase Adaptive Server Enterprise でのみ有効）
Async
機能
PowerBuilder において、データベースに対する非同期処理を有効にし
ます。たとえば、データウィンドウオブジェクトまたはレポートに
RetrieveRow イベントを指定した場合、現行のデータベース検索処理が
まだ終了していなくても、その処理をキャンセルしたり、同じデータ
ベース接続を使用しない別の（データベースとは無関係の）処理を起
動します。また、検索処理が行われている間に、別の Windows プロセ
スに切り替えることもできます。
デフォルトでは、 PowerBuilder は同期処理をします。
対象
IN9 Informix
JDB JDBC
ODBC（ドライバおよびバックエンド DBMS がサポートしている場合）
O84 Oracle8i （8.1.5 以降のデータベース接続のみ）
O90 Oracle9i
O10 Oracle 10g
SYC Sybase Adaptive Server Enterprise
構文
Async = value
パラメータ
value
説明
同期処理または非同期処理を指定する値。以下のいずれか
の値を指定します。
• 0 （デフォルト）同期処理
• 1 非同期処理
デフォルト値
Async = 0
解説
PowerBuilder における非同期処理を有効にすると、結果を返すのに時
間がかかる複雑な SQL 文を実行するときに効果的です。 Async パラ
メータが 1 に設定されている場合、 SQL 文の実行中に以下の操作がで
きます。
•
別のウィンドウでの処理
•
最初の行のデータを取得する前の、 SQL 文のキャンセル
Async を設定するタイミングコードでデータベースと通信している
場合は、トランザクションオブジェクトがデータベースと接続する前
と後のどちらでも、 Async 値をリセットできます。
接続リファレンス
7
Async
データ取得に伴う処理データウィンドウオブジェクトまたはレ
ポートの中でデータの取得をすると、以下の順番で処理が行われます。
1
データベースサーバが SQL 文をコンパイルし、実行します。
2
PowerBuilder が最初の行のデータを取得（フェッチ）します。
3
PowerBuilder が以降の各行のデータを取得します。
最初の行が取得される前にする操作サーバが SQL 文をコンパイル
し、実行している間で、かつ、 PowerBuilder が最初の行のデータを取
得する前に、非同期処理を有効にするためには、以下の操作を両方と
も実行しておきます（これによって、最初の行のデータが取得される
前に、この処理をキャンセルできます）。
•
データウィンドウ
オブジェクトまたはレポートに対して
RetrieveRow イベントを指定します（コードにはコメントだけの指
定もできます）。
•
Async パラメータを 1 に設定します。
最初の行が取得された後でする操作最初の行のデータが取得された
後、以降の行をフェッチする間に、非同期処理を有効にするためには、
以下の操作を実行しておきます。
•
データウィンドウ
オブジェクトまたはレポートに対して
RetrieveRow イベントを指定します。
最初の行が取得された後は、 Async パラメータを 1 に設定しなくても、
PowerBuilder は非同期処理をします。したがって、最初の行のデータが
取得された後はいつでも、現行の操作をキャンセルできます。したがっ
て、最初の行のデータが取得された後、 Async パラメータを設定して
も意味はありません。
例
例 1 非同期処理を有効にするには以下のようにします。
DB プロファイル設定ダイアログボッ
クスの［トランザクション］タブの［非同期］チェックボックス
をオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "Async=1"
例 2 1 つの文に Async パラメータと DBGetTime パラメータの両方を
指定できます。 DBGetTime パラメータは、データウィンドウオブジェ
クトまたはレポートの中で行を検索するときの、 DBMS からの応答待
ち時間を秒単位に指定します。非同期処理を有効にした上で、
DBGetTime パラメータを 20 秒に設定するには以下のようにします。
8
PowerBuilder
第1章
データベースパラメータの解説
DB プロファイル設定ダイアログボッ
クスの［トランザクション］タブで、［非同期］チェックボックス
をオンにし、［処理待ち時間］ボックスに 20 と入力します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "Async=1,DBGetTime=20"
関連項目
DBGetTime
BindSPInput
機能
PowerBuilder がストアドプロシージャの実行時に、動的 SQL 文の入力
パラメータをバインドするように指定します。
対象
O84 Oracle8i
O90 Oracle9i
O10 Oracle 10g
構文
BindSPInput = value
パラメータ
value
説明
ストアドプロシージャの実行時に、動的 SQL 文の入力パ
ラメータをバインドするかどうかを指定します。以下のい
ずれかの値を指定します。
• No （デフォルト） PowerBuilder はストアドプロシー
ジャの実行時に、動的 SQL 文のパラメータをバインド
しません。
• Yes PowerBuilder はストアドプロシージャの実行時
に、動的 SQL 文のパラメータをバインドします。
デフォルト値
BindSPInput = 'No'
例
PowerBuilder がストアドプロシージャの実行時に、動的 SQL 文のパラ
メータをバインドするように指定するには、スクリプトに次のように
入力します。
SQLCA.DBParm = "BindSPInput = 'Yes'"
関連項目
接続リファレンス
DisableBind
9
BinTxtBlob
BinTxtBlob
機能
バイナリデータまたは ANSI 文字列を、 UPDATEBLOB でテキストカラ
ムに発行するか、 SELECTBLOB で検索することを指定します。
対象
IN9 Informix
OLE DB
O84 Oracle 8.x および Oracle8i
O90 Oracle9i
O10 Oracle 10
SYC Sybase Adaptive Server Enterprise
構文
BinTxtBlob = value
パレメータ
value
説明
UPDATEBLOB でデータベース内のテキストカラムに発行
されるか、 SELECTBLOB で検索される PowerBuilder Blob
が、バイナリデータを含むか ANSI 文字列を含むかを指定
します。以下のいずれかの値を指定します。
• 0 Blob は Unicode 文字列を含みます。
• 1 Blob は Unicode 文字列とみなされない種類のデータ
を含みます。
デフォルト値
BinTxtBlob=0
解説
デフォルトでは、テキストデータ型（Oracle の場合は long または clob、
Adaptive Server や SQL サーバにアクセスする OLE DB の場合は text）の
データベースカラムで UPDATEBLOB と SELECTBLOB SQL 文を使用す
る場合、更新または選択される PowerBuilder Blob は Unicode 文字列を
含むことを求められます。 Bolob がバイナリデータまたは ANSI 文字
列などの別の種類のデータを含む場合は、 SELECTBLOB
または
UPDATEBLOB を呼び出す前に、 BinTxtBlob データベースパラメータを
1 に設定します。これは PowerBuilder またはデータベースサーバが
Unicode への変換や Unicode からの変換を行わないようにします。
Oracle O84 Oracle O84 インタフェースは、ANSI データベースハンド
ルを使用します。デフォルト設定（BinTxtBlob=0）で UPDATEBLOB を
使用すると、 O84 インタフェースは、データをサーバに送信する前に
クライアントの NLS_LANG 設定に基づいて、 Unicode 文字列を ANSI
または UTF-8 に変換します。 SELECTBLOB では、 O84 インタフェース
はサーバから ANSI または UTF-8 文字列を取得して、それを Unicode
(UCS-2) 文字列に変換します。
BinTxtBlob を 1 に設定すると、 O84 インタフェースは変換せずに直接
データを転送します。
10
PowerBuilder
第1章
データベースパラメータの解説
Oracle O90 および O10 Oracle O90 および O10 インタフェースは、
Unicode データベースハンドルを使用します。デフォルト設定
（BinTxtBlob=0）で UPDATEBLOB を使用すると、それらのインタフェー
スは、Oracle サーバに直接データを送信し、バイナリデータが Unicode
文字列を含むことをサーバに知らせます。必要な変換はサーバが行い
ます。 SELECTBLOB では、それらのインタフェースはサーバから
Unicode 文字列を取得します。
BinTxtBlob を 1 に設定すると、NLS_LANG 環境変数の値でバインドす
る文字セットが決まります。 ANSI 文字列またはバイナリデータは、
PowerBuilder 9 以前のリリースのようにサーバにあるいはサーバから
直接転送されます。
O90 インタフェースで BinTxtBlob を 1 に設定するには、Oracle 9.2 以降
のクライアントを使用する必要があります。使用しないとエラーを受
け取ります。
OLE DB および SYC BinTxtBlob を 0 に設定すると、 OLE DB および
SYC インタフェースが必要な変換を行います。 BinTxtBlob を 1 に設定
すると、データは変換されずにサーバに渡されます。
例
コードでは、 ANSI 文字列データまたはバイナリデータを含む
PowerBuilder Blob で SELECTBLOB または UPDATEBLOB を呼び出す前
に、 BinTxtBlob パラメータを 1 に設定します。
SQLCA.DBParm = "BinTxtBlob=1"
処理を Unicode 文字列データを含む Blob で行う必要がある場合は、デ
フォルトの設定 0 に戻してください。
たとえば、クライアントメモリに “65 00 66 00 67 00” と格納された
Unicode 文字列 “ABC” を、 UPDATEBLOB を使用してデータベースで更
新すると仮定します。 BinTxtBlob が 0 に設定されると、データは ANSI
に変換され、データベーステキストカラムに “65 66 67” と格納されま
す。 BinTxtBlob が 1 に設定されると、変換は行われず、データはそれ
のもとの形式で “65 00 66 00 67 00” と格納されます。
Block （ODBC、 OLE DB、 Oracle）
機能
Block をサポートするインタフェースの場合に、データベースと接続す
るときにカーソルブロックファクタを指定します。ブロックファクタ
は、データウィンドウオブジェクトがデータベースから一度にフェッ
チできる行数を決定します。
Block パラメータを使用すると、PowerBuilder からデータベースにアク
セスするときのパフォーマンスが向上します。
接続リファレンス
11
Block （ODBC、 OLE DB、 Oracle）
対象
ODBC（ドライバおよびバックエンド DBMS がサポートしている場合）
OLE DB
O84 Oracle8i
O90 Oracle9i
O10 Oracle 10g
構文
Block = blocking_factor
パラメータ
blocking_factor
説明
データウィンドウオブジェクトがデータベースから一
度にフェッチする行数。1 ～ 1000 の範囲の値を指定しま
す。
ブロックフェッチを無効にするには、 Block パラメータ
に 1 を指定します。
デフォルト値
以下の表に示すように、 Block パラメータのデフォルト値は、アクセス
している DBMS によって異なります。
DBMS
ODBC
Block パラメータのデフォルト値
大部分のデータウィンドウオブジェクトの場合、 Block パラメー
タのデフォルト値は以下のとおりです。最大値は 32K / カラムで
す。
Block = 1000
データウィンドウオブジェクトが、必要な行だけをデータベース
から取得することを指定した場合（Retrieve.AsNeeded プロパ
ティ）、 Block パラメータのデフォルト値は以下のとおりです。な
お、最大値は 32K / カラムです。
Block = 100
OLE DB
Oracle
ブロックファクタは 1 に設定されます。
ブロックファクタは 300 行に設定されます。
デフォルトブロックファクタの使用
Block パラメータに対して、デフォルト以外の値を設定する必要はあり
ません。ほとんどの場合、 PowerBuilder の使用するデフォルトブロッ
クファクタで十分な結果が得られます。
解説
12
ODBC データソースの要件 ODBC データソースで Block DBParm パ
ラメータを使用するには、 ODBC ドライバが以下の要件を満たしてい
る必要があります。
•
ODBC バージョン 2.0 以上に準拠している
•
SQLExtendedFetch API 呼び出しをサポートしている
PowerBuilder
第1章
データベースパラメータの解説
PowerBuilder で提供される Adaptive Server® Anywhere ODBC ドライバ
は、この要件を両方とも満たしています。
使用している ODBC ドライバが要件を満たしているかどうかについて
は、ドライバ付属のマニュアルを参照してください。
ODBC データソースの Block 値の決定 PowerBuilder は以下の順序で
検索をし、 ODBC データソースの Block 値を決定します。
1
レジストリ内のデータベースプロファイルに対応するセクション
（開発環境の場合）。または、トランザクションオブジェクトプロ
パティの値（アプリケーションの場合）。
2
使用している ODBC ドライバに対応する、 PBODB100 初期設定
ファイルの中のセクション
どちらの場所にも Block 値の指定が見つからない場合は、アクセスし
ている DBMS に対応する Block パラメータのデフォルト値が使用され
ます。
ブロックフェッチの無効化 ODBC データソースや Oracle データ
ベースに対するブロックフェッチを無効にするには、 Block パラメー
タに 1 を設定します。
OLE DB と Microsoft SQL Server OLE DB データベースインタフェー
スを使用して Microsoft SQL Server データベースへ接続している場合、
データウィンドウへデータを取り込んだり SELECT 文で埋め込み SQL
カーソルを使用している場合、複数のコマンド実行をサポートするた
めにサーバ側のカーソルが使用されます。これによりパフォーマンス
が悪化する場合には、 Block データベースパラメータのサイズを 500
以上に増やすか、 PBODB100.INI ファイルの [Microsoft SQL Server] セ
クションに次の一行を追加してサーバ側のカーソルをオフにします。
ServerCursor='NO'
Oracle と MaxFetchBuffer Oracle では、行のサイズがとても大きい時
はパフォーマンスを上げるために、Block パラメータを MaxFetchBuffer
データベースパラメータとともに使用できます。 MaxFetchBuffer パラ
メータのデフォルト値は 5000000 バイトで、たいていのアプリケー
ションでは十分な値です。実際のフェッチバッファのサイズは、ブ
ロックファクタの値に行のサイズを掛けた値になります。
ブロックファクタが要求するフェッチバッファと行サイズが
MaxFetchBuffer の値より大きい場合は、ブロックファクタの値がバッ
ファを超えないように調整します。たとえば、 block = 500 で行サイズ
が 10KB の場合は、フェッチバッファは 5000KB になり、デフォルト
の最大バッファサイズに等しくなります。
接続リファレンス
13
Block （Adaptive Server Enterprise）
例
データウィンドウオブジェクトのブロックファクタを 50 行に設定す
るには以下のようにします。
DB プロファイル設定ダイアログボッ
クスの［トランザクション］タブの［検索ブロック化係数］ボッ
クスに 50 と入力します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "Block=50"
関連項目
MaxFetchBuffer
Block （Adaptive Server Enterprise）
機能
カーソルを宣言するときに、 Sybase Client Library （CT-Lib）インタ
フェースが使用する内部ブロックファクタを指定します。ブロック
ファクタは、 CT-Lib が物理的なデータリクエストをするときに、デー
タベースから一度にフェッチできる行数を決定します。
Block DBParm パラメータは、宣言されたカーソルに対してだけ適用さ
れ、データウィンドウオブジェクトには適用されません。
対象
SYC および SYJ Sybase Adaptive Server Enterprise
構文
Block = blocking_factor
パラメータ
blocking_factor
デフォルト値
例
説明
CT-Lib が物理的なデータリクエストをするときに、デー
タベースから一度にフェッチする行数。デフォルトブ
ロックファクタは 100 行です。
Block = 100
例1
ブロックファクタを 1000 行に設定するには以下のようにしま
す。
•
DB プロファイル設定ダイアログボッ
クスの［トランザクション］タブの［検索ブロック化係数］ボッ
クスで、以下の入力を行います。
データベースプロファイル
1000
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "Block=1000"
14
PowerBuilder
第1章
データベースパラメータの解説
以下の埋め込み SQL 文では、コードでブロックファクタを設定
し、これを使用してカーソルを宣言する方法が示されています。以下
のステートメントは、ブロックファクタを 1000 行に設定し、この内
部ブロックファクタを使用するカーソルを宣言します。
例2
SQLCA.DBParm = "Block=1000"
DECLARE dept_cursor CURSOR FOR
SELECT dept_id, dept_name FROM department
USING SQLCA;
OPEN dept_cursor;
関連項目
MaxFetchBuffer
CacheAuthentication
機能
OLE DB データプロバイダがパスワードなどの認証情報を内部キャッ
シュにキャッシュできるかどうかを指定します。
CacheAuthentication を指定するタイミング
CacheAuthentication パラメータは、データベースに接続する前に指定
します。
対象
OLE DB
構文
CacheAuthentication = 'value'
パラメータ
value
説明
OLE DB データプロバイダが認証情報をキャッシュできるか
どうかを指定します。以下のいずれかの値を指定します。
• True OLE DB データプロバイダが情報をキャッシュする
• False （デフォルト） OLE DB データプロバイダは情報を
キャッシュしない
デフォルト値
CacheAuthentication = 'False'
例
OLE DB データプロバイダが認証情報をキャッシュするようにするに
は以下のようにします。
DB プロファイル設定ダイアログボッ
クスの［セキュリティ］タブの［認証のキャッシュ］チェックボッ
クスをオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "CacheAuthentication='True'"
接続リファレンス
15
CacheName
関連項目
DataLink
IntegratedSecurity
CacheName
機能
PowerBuilder が名前で EAServer 接続キャッシュを指定できるようにし
ます。このデータベースパラメータは、 PowerBuilder カスタムクラス
ユーザオブジェクトが EAServer コンポーネントとして配布される場
合だけ使用します。
対象
JDB JDBC
ODBC
O84 Oracle8i
O90 Oracle9i
SYJ Sybase Adaptive Server Enterprise
SYJ インタフェースの使用
Sybase EAServer では、わずかに異なるバージョンの CT-Lib ソフトウェ
アが使用されます。したがって、実行時に、 Adaptive Server Enterprise
データベースに接続するには SYC ではなく SYJ データベースインタ
フェースを使用する必要があります。 SYJ の DB プロファイル設定ダ
イアログボックスを使用すると、適切な接続パラメータが設定され、
構文を［プレビュー］タブからトランザクションオブジェクトのスク
リプトにコピーできます。
ただし、 PowerBuilder 開発環境からデータベースに接続する場合には
SYJ インタフェースを使用できません。したがって、開発段階では（コ
ンポーネントが EAServer に配布される前）、 SYC を使用してデータ
ベースに接続する必要があります。
構文
CacheName = 'value'
デフォルト値
なし
解説
EAServer 接続キャッシュを使用する PowerBuilder カスタムクラス
ユーザオブジェクトを作成する場合は、ユーザ名、パスワード、サー
バ名、および接続ライブラリを指定する必要があります。ただし、
EAServer で「名前でキャッシュにアクセスできる」オプションが有効
になっている場合は、接続キャッシュ名だけを入力して接続キャッ
シュを指定します。
16
PowerBuilder
第1章
データベースパラメータの解説
PowerBuilder を使用して EAServer コンポーネントを作成する方法につ
いては、『アプリケーションテクニック』マニュアルを参照してくだ
さい。
このパラメータは、動的に設定することができません。接続の確立時
に設定された値は、接続が切断するまで有効です。
例
DB プロファイル設定ダイアログボックスの［EAServer］タブの［名
前でキャッシュにアクセス］チェックボックスをオンにし、［キャッ
シュ名］ボックスに EAServer キャッシュ名を入力します。 CacheName
DBParm パラメータの PowerScript 構文が［プレビュー］タブに表示さ
れます。
SQLCA.DBParm = "CacheName = 'mydbcache'"
この構文を［プレビュー］タブからスクリプトにコピーします。
関連項目
GetConnectionOption
ReleaseConnectionOption
UseContextObject
CallEscape
機能
ODBC インタフェースが、ストアドプロシージャコール（デフォル
ト）に CallEscape 構文を使用するか、または ODBC ドライバにコマン
ドを送る前に、ストアドプロシージャコールをドライバ固有のネイ
ティブ SQL 構文に変換するかを制御します。
対象
ODBC（ドライバおよびバックエンド DBMS がサポートしている場合）
構文
CallEscape='value'
パラメータ
value
デフォルト値
接続リファレンス
説明
ODBC インタフェースがストアドプロシージャコールに
CallEscape 構文を使用するか、またはストアドプロシー
ジャコールをドライバ固有のネイティブ SQL 構文に変換
します。以下のいずれかの値を指定します。
• Yes （デフォルト） ODBC インタフェースは、ストアド
プロシージャコールに CallEscape 構文を使用します。
• No ODBC インタフェースは、 ODBC ドライバにコマン
ドを送る前に、ストアドプロシージャコールをドライバ
固有のネイティブ SQL 構文に変換します。
CallEscape = 'Yes'
17
CharSet
解説
設定が必要な場合使用している ODBC ドライバが、 CallEscape 構文
ではなく、ネイティブ（ドライバ固有の） SQL 構文のストアドプロ
シージャコールを受け取る場合は、 CallEscape を No に設定します。
使用している ODBC ドライバのストアドプロシージャコールについ
ては、各ベンダのマニュアルを参照してください。
レベル 2 以上の ODBC ドライバ要件 CallEscape パラメータを使うた
めには、 ODBC ドライバが、レベル 2 以上の API 合致要件を満たして
いる必要があります。コアまたはレベル 1 の API 合致要件を満たす
ODBC ドライバを使っている場合は、 CallEscape には影響がありませ
ん。
ストアドプロシージャ CallEscape 構文の例以下の例は、 CallEscape
構文を使用する sp_test というストアドプロシージャコールを説明し
ています。
{call sp_test(1,1)}
例
ODBC ドライバにコマンドを送る前に、ストアドプロシージャコール
をドライバ固有のネイティブ SQL 構文に変換します。
DB プロファイル設定ダイアログボッ
クスの［構文］タブの［エスケープ呼び出し構文を使用する］チェッ
クボックスをオフにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "CallEscape='No'"
CharSet
機能
Sybase Adaptive Server Enterprise を介してアクセスするデータベースに
接続するときに、 Sybase Open Client™ ソフトウェアが使用する文字
セットを指定します。
CharSet を指定するタイミング
CharSet パラメータは、データベースに接続する前に指定します。
対象
SYC Sybase Adaptive Server Enterprise
構文
CharSet = 'character_set'
デフォルト値
なし
解説
CharSet パラメータに値を指定すると、 PowerBuilder は以下の処理をし
ます。
18
PowerBuilder
第1章
データベースパラメータの解説
•
この接続に対して CS_LOCALE 構造体を割り当てる
•
指定する文字セットを CS_SYB_CHARSET 値に設定する
•
SQL Server CS_LOC_PROP 接続プロパティに、新しいロケール情
報を設定する
Locale パラメータ設定の無効化 Locale パラメータは、使用する言語
や文字セットを指定します。この Locale パラメータがすでに設定され
ている場合、 CharSet パラメータに新しい値を指定し、データベースと
再接続することによって、文字セットの設定を変更できます。
Unicode データアクセス PowerBuilder は、 Adaptive Server Enterprise
（ASE） 12.5 Unicode データベース中、または ASE 12.5 の Unicode カラ
ム中の Unicode データにアクセスすることができます。 PowerBuilder
は、 CharSet と Language パラメータで設定されている DBCS の値（ま
たは、 Locale パラメータで設定されている DBCS の値）に従って、 2
バイト文字コードセット（DBCS）データと Unicode データとを自動的
に変換します。この例を以下に示します。
CharSet = 'sjis'
Language = 'japanese'
例
文字セットを iso_1 に設定するには以下のようにします。
•
DB プロファイル設定ダイアログボッ
クスの［地域の設定］タブの［文字セット］ボックスで、以下の
入力を行います。
データベースプロファイル
iso_1
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "CharSet='iso_1'"
関連項目
Language
Locale
CnnPool
機能
Oracle が接続をプールするかどうかを指定します。 Oracle の接続プー
ルはいくつかのセッションにまたがり、 Oracle Call Interface （OCI）に
よって管理される物理的な再利用可能なグループです。 CnnPool パラ
メータは、 EAServer へ配布される PowerBuilder コンポーネントのため
には使用できません。また、外部ユーザは、接続プールに参加するこ
とはできません。デフォルトでは、接続プールは使用しません。
対象
O90 Oracle9i
接続リファレンス
19
CnnPool
O10 Oracle 10g
構文
CnnPool = 'value'
パラメータ
value
説明
以下のいずれかの値を指定します。
• Yes
• No （デフォルト）
デフォルト値
No
解説
CnnPool='Yes' の場合、Oracle9i または Oracle 10g クライアントは接続
プールを作成し、 Oracle 8、 Oracle8i、 Oracle9i、および Oracle10g サー
バへの接続が可能になります。プールには Oracle サーバへの物理的な
接続情報が含まれていて、 OCI によって管理されています。プールは、
PowerBuilder が終了するまで、または OCI.dll がアンロードされるまで
保持されます。
データウィンドウサーバはサービス名で識別して、異なる 10 個の
Oracle サーバへ同時に接続することが可能です。 1 プールについて 20
接続まで可能です。各プールは Oracle9i 以降のクライアントによって
作成され、 Oracle8 と Oracle8i サーバへの接続を含むことも可能です。
一度接続プールが作成されると、 PowerBuilder が終了するまで、また
は OCI.DLL がアンロードされるまで、物理的な接続を保持します。
例
接続プールを使用するには以下のようにします。
•
DB プロファイル設定ダイアログボッ
クスで［接続］タブの以下のフィールドに値を入力してください。
データベースプロファイル
•
プロファイル名－例： 08i-pool
•
サーバ－ Oracle Net で作成されたネットサービス名をフルで
指定します。例： adcora8i.sybase.com
•
ログイン ID －例： scott
•
パスワード
•
接続モード－ドロップダウンメニューから項目を選択しま
す。例： Default
［接続プールの使用］を選択していることを確認してください。
•
アプリケーションコードに次のように入力します。 password、
server_name、および login は接続先に適した値を入れてください。
SQLCA.DBMS = "O90 Oracle9i (9.0.1)"
SQLCA.LogPass = <password>
SQLCA.ServerName = "server_name"
20
PowerBuilder
第1章
データベースパラメータの解説
SQLCA.LogId = "login"
SQLCA.AutoCommit = False
SQLCA.DBParm = "CnnPool='Yes'"
CommandTimeout
機能
コマンドが実行するのをインタフェースが待つ秒数を指定します。
CommandTimeout を指定するタイミング
CommandTimeout パラメータはデータベースから接続する前に指定し
ます。
対象
ADO.NET
構文
CommandTimeout = value
パラメータ
value
説明
コマンドが実行するのをインタフェースが持つ秒数
デフォルト値
なし
解説
CommandTimeout パラメータのデフォルト値はドライバによって異な
ります。
例
コマンド実行まで 60 秒待つように CommandTimeout 値を設定するに
は以下のようにします。
•
DB プロファイル設定ダイアログボッ
クスの [ システム ] タブの［コマンドタイムアウト］ボックスに
60 と入力します。
•
アプリケーション
データベースプロファイル
コードに次のように入力します。
SQLCA.DBParm = "CommandTimeout=60"
CommitOnDisconnect
機能
接続リファレンス
データソースから接続を解除する前に、 PowerBuilder がコミットされ
ていないデータベースの更新をすべてコミット（デフォルトの処理）
するか、またはロールバックするかを指定します。
21
CommitOnDisconnect
CommitOnDisconnect を指定するタイミング
CommitOnDisconnect パラメータは、データベースに接続する前に指定
します。
対象
SYJ 以外のすべてのデータベースインタフェース
構文
CommitOnDisconnect = 'value'
パラメータ
value
説明
データソースから接続を解除する前に、 PowerBuilder がコ
ミットされていないデータベースの更新をすべてコミット
するか、ロールバックするかを指定します。以下のいずれ
かの値を指定します。
• Yes （デフォルト）アプリケーションを終了したとき、
またはコードで明示的に DISCONNECT 文が発行された
ときに、コミットされていないデータベースの更新がす
べてコミットされます。
• No PowerBuilder アプリケーションを終了したとき、ま
たはコードで明示的に DISCONNECT 文が発行されたと
きに、コミットされていないデータベースの更新がすべ
てロールバックされます。この場合、データベースから
接続を解除するときに、 PowerBuilder は更新内容を自動
的にコミットしません。
デフォルト値
CommitOnDisconnect = 'Yes'
解説
CommitOnDisconnect は、データベースから接続を解除するときに、コ
ミットされていないデータベースの更新が、自動的にコミットされる
のではなく、ロールバックされるようにしたい場合に No に設定しま
す。
例
データベースから接続を解除するときに、コミットされていないデー
タベースの更新が自動的にコミットされるのではなく、ロールバック
されるようにするには、以下のようにして CommitOnDisconnect を No
に設定します。
DB プロファイル設定ダイアログボッ
クスの［接続］タブの［接続終了時にコミット］チェックボック
スをオフにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "CommitOnDisconnect='No'"
22
PowerBuilder
第1章
データベースパラメータの解説
ConnectAs
機能
ユーザが SYSOPER または SYSDBA のシステム権限で Oracle サーバに
接続することを許可します。
対象
O90 Oracle9i
O10 Oracle 10g
構文
ConnectAs = 'value'
パラメータ
value
説明
以下のいずれかの値を指定します。
• SYSDBA
• SYSOPER
• Normal
（デフォルト）
デフォルト値
Normal
解説
ConnectAs ='Normal' の場合、このパラメータは使用されません。
ConnectAs ='SYSDBA' または ConnectAs ='SYSOPER' の場合に、Oracle9i
以降はユーザに SYSDBA または SYSOPER 権限が付与されたものとみ
なして、そのユーザが接続することを許可します。
ConnectAs ='SYSDBA' を使用して接続する場合、Oracle9i 以降は事前に
ユーザ ID に関係付けられているスキーマのかわりに、SYS スキーマを
使用します。 ConnectAs ='SYSOPER' を使用して接続する場合、Oracle9i
以降は PUBLIC スキーマを使用します。
CnnPool = 'Yes' と設定した状態では使用しないでください。
接続プールは、このパラメータと一緒に使用することはできません。
DB プロファイル設定ダイアログボックスの［接続プールの使用］ま
たは CnnPool を 'Yes' に設定しないでください。
例
ユーザ ID に関連付けられているスキーマのかわりに、SYS スキーマを
使用するには以下のようにします。
•
DB プロファイル設定ダイアログボッ
クスの［接続］ページで、［接続モード］ドロップダウンリストの
「SYSDBA」を選択し、［接続プールの使用］を選択していないこ
とを確認してください。
•
アプリケーション
データベースプロファイル
コードに次のように入力します。
SQLCA.DBParm = "ConnectAs='SYSDBA'"
接続リファレンス
23
ConnectOption
ConnectOption
機能
PowerBuilder から ODBC データソースに接続するときに、ドライバ固
有の接続オプションを設定します。オプションで指定する内容は以下
のとおりです。
•
ODBC ドライバが接続の追加情報を求める方法
•
Microsoft SQL Server 接続に対するセキュリティの種類
•
ODBC ドライバマネージャトレースのオン / オフと、使用するト
レースファイル
•
SQLTransact 呼び出しに伴うカーソルの動作。カーソルを閉じる
か、開いたままにするかを指定
•
SQLPrepare 呼び出しに対するテンポラリストアドプロシージャ
の処理
一部の ConnectOption パラメータは、すべての ODBC ドライバに適用
されますが、それ以外のパラメータは特定の ODBC ドライバだけに適
用されます。
各 ConnectOption パラメータの内容と、どの ODBC ドライバで使用で
きるかについては、以下の「構文」の中の一覧表を参照してください。
ConnectOption を指定するタイミング
ConnectOption パラメータは、ODBC データソースに接続する前に指定
します。 ConnectOption の設定は、データベースに接続するときにその
効果を発揮します。
対象
ODBC（ドライバおよびバックエンド DBMS がサポートしている場合）
構文
ConnectOption = ' SQL_DRIVER_CONNECT,value;
SQL_INTEGRATED_SECURITY,value;
SQL_OPT_TRACE,value;
SQL_OPT_TRACEFILE,value;
SQL_PRESERVE_CURSORS,value;
SQL_USE_PROCEDURE_FOR_PREPARE,value '
以下の表に、各 ConnectOption パラメータを指定できる ODBC ドライ
バとパラメータの目的や、パラメータに指定できる値を示します。
24
PowerBuilder
第1章
パラメータ
SQL_DRIVER_CONNECT
接続リファレンス
データベースパラメータの解説
説明
ドライバ SQLDriverConnect API 呼び出しをサポートするす
べての ODBC ドライバ
目的 ODBC データソースに接続するときに、 ODBC ドラ
イバが接続の追加情報（ユーザ ID やパスワードなど）を求
める方法を指定します。
値以下のいずれかの値を指定します。
•
SQL_DRIVER_COMPLETE
（デフォルト）接続文字列の情報が正確で十分な場合、
ドライバは指定されたデータソースに接続します。一
方、情報が正確でなかったり、足りない場合、ドライ
バは 1 つ以上のダイアログボックスを表示して、接続
に必要な情報の入力を求めます。この情報が入力され
ると、ドライバは指定されたデータソースに接続しま
す。
•
SQL_DRIVER_COMPLETE_REQUIRED
ドライバは、 SQL_DRIVER_COMPLETE が設定された
場合と同じ動作をします。さらに、データソースに接
続するのに必要でない情報に対するコントロールを無
効にします。
•
SQL_DRIVER_PROMPT
ドライバは、 1 つ以上のダイアログボックスを表示し
て、接続に必要な情報の入力を求めます。この後、指
定されたデータソースに接続し、ダイアログボックス
に指定された情報を基に接続文字列を作成します。
•
SQL_DRIVER_NOPROMPT
接続文字列の情報が正確で十分な場合、ドライバは指
定されたデータソースに接続します。一方、情報が正
確でなかったり、足りない場合、ドライバはエラーを
返します。
25
ConnectOption
パラメータ
SQL_INTEGRATED_ SECURITY
SQL_OPT_TRACE
説明
ドライバ Microsoft SQL Server ODBC ドライバ
（PowerBuilder では提供されません）
目的 Microsoft SQL Server データベースサーバとの接続の
種類を指定します。
値以下のいずれかの値を指定します。
• SQL_IS_OFF （デフォルト）標準セキュリティを使用
する、 SQL Server への標準の（信頼性のない）接続を要
求します。SQL_IS_OFF を指定すると、統合セキュリティ
を使用する、 SQL Server への信頼された接続は要求でき
ません。
• SQL_IS_ON データベースサーバ上で現在使用されて
いるログオンセキュリティモードにかかわらず、統合セ
キュリティを使用する、 SQL Server への信頼された接続
を要求します。
Microsoft SQL Server におけるセキュリティメカニズムにつ
いては、 Microsoft のマニュアルを参照してください。
ドライバすべての ODBC ドライバ
目的 PowerBuilder の中で ODBC ドライバマネージャト
レースをオンまたはオフにして、 ODBC データソースとの
接続についてトラブルシューティングをします。 ODBC ド
ライバマネージャトレースは、ODBC データソースに接続
するときに、 PowerBuilder の ODBC API 関数呼び出しにつ
いて、詳細な情報を提供します。
値以下のいずれかの値を指定します。
•
SQL_OPT_TRACE_OFF
（デフォルト） ODBC ドライバマネージャトレースを
オフにします。
•
SQL_OPT_TRACE_ON
ODBC ドライバマネージャトレースをオンにします。
ODBC ドライバマネージャトレースを使用する手順につ
いては、『データベースとの接続』マニュアルの「ODBC ド
ライバマネージャトレース」を参照してください。
26
PowerBuilder
第1章
パラメータ
SQL_OPT_TRACEFILE
SQL_PRESERVE_ CURSORS
データベースパラメータの解説
説明
すべての ODBC ドライバ
目的 ODBC ドライバマネージャトレースの出力を送るト
レースファイルの名前を指定します。 PowerBuilder は、ト
レースを中止するまで、出力をトレースファイルに追加し
ます。トレースファイルを表示するには、ファイルエディ
タ（PowerBuilder の内部の環境）、またはテキストエディタ
（PowerBuilder の外部の環境）を使用します。
値トレースファイル名として、どのようなファイル名を
指定してもかまいません。ただし、使用しているオペレー
ティングシステムの命名規約に従う必要があります。デ
フォルトでは、トレースがオンになっていて、トレースファ
イル名が指定されていない場合、 ODBC ドライバマネー
ジャトレースの出力はファイル \SQL.LOG に送られます。
ドライバ Microsoft SQL Server ODBC ドライバ
（PowerBuilder では提供されません）
目的 SQLTransact 呼び出しに伴い、カーソルを閉じるか、
または開いたままにしておくかを指定します。
値以下のいずれかの値を指定します。
ドライバ
•
SQL_PC_OFF
（デフォルト） SQLTransact 呼び出しに伴い、すべての
カーソルを閉じます。
•
SQL_USE_PROCEDURE_ FOR_PREPARE
接続リファレンス
SQL_PC_ON
SQLTransact 呼び出しに伴い、サーバカーソルを開いた
ままにします。
ドライバ Microsoft SQL Server ODBC ドライバ
（PowerBuilder では提供されません）
目的 SQLPrepare 呼び出しに対する一時ストアドプロシー
ジャの処理のしかたを指定します。
値以下のいずれかの値を指定します。
•
SQL_UP_ON
（デフォルト） SQLPrepare 呼び出しに対して、一時スト
アドプロシージャを作成します。
•
SQL_UP_OFF
SQLPrepare 呼び出しに対して、一時ストアドプロシー
ジャを作成しません。 SQL 文は、実行時に格納、コン
パイルが実行されます。構文エラーのチェックは、実
行時にされます。
•
SQL_UP_ON_DROP
一時ストアドプロシージャは、以降の SQLPrepare 呼び
出しに対して、またはステートメントハンドル（hstmt）
が開放されたときに明示的に削除します。
27
ConnectOption
デフォルト値
ConnectOption = 'SQL_DRIVER_CONNECT, SQL_DRIVER_COMPLETE;
SQL_INTEGRATED_SECURITY,SQL_IS_OFF;
SQL_OPT_TRACE,SQL_OPT_TRACE_OFF;
SQL_PRESERVE_CURSORS,SQL_PC_OFF;
SQL_USE_PROCEDURE_FOR_PREPARE,SQL_UP_ON'
解説
Microsoft Server ODBC ドライバ ConnectOption パラメータは、Microsoft
SQL Server ODBC ドライバで、 SQL Server データベースにアクセスす
るときに限って適用されます。
Microsoft SQL Server ODBC ドライバは、Microsoft 社から入手する必要
があります。このドライバは、 PowerBuilder では提供しません。
例
ConnectOption パラメータに、デフォルト値でないオプションを指定す
るには以下のようにします。
•
DB プロファイル設定 - ODBC ダイアロ
グボックスの［オプション］タブで値を入力します。各
ConnectOption パラメータは、次の表に示すように、このダイアロ
グボックスのオプションに対応しています。
データベースプロファイル
ConnectOption パラメータ
SQL_DRIVER_CONNECT
SQL_INTEGRATED_SECURITY
SQL_OPT_TRACE
SQL_OPT_TRACEFILE
SQL_PRESERVE_CURSORS
SQL_USE_PROCEDURE_FOR_PREPARE
•
アプリケーション
対応するオプション
接続の種類
統合セキュリティ
ODBC API 呼出のトレース
トレースファイル
カーソルの保持
Prepare 時に使用するプロ
シージャ
コードに次のように入力します。
SQLCA.DBParm = "ConnectOption =
'SQL_DRIVER_CONNECT,SQL_DRIVER_NOPROMPT;
SQL_INTEGRATED_SECURITY,SQL_IS_ON;
SQL_OPT_TRACE,SQL_OPT_TRACE_ON;
SQL_OPT_TRACEFILE,C:\PB10\odbctrce.log;
SQL_PRESERVE_CURSORS,SQL_PC_ON;
SQL_USE_PROCEDURE_FOR_PREPARE,SQL_UP_OFF'"
28
PowerBuilder
第1章
データベースパラメータの解説
ConnectString
機能
ODBC データソースに接続するために必要なパラメータを指定しま
す。 PowerBuilder は、 ConnectString パラメータを使用してデータベー
スに接続します。
対象
ODBC
構文
ConnectString は、 1 行で記述します。なお、 ConnectString を構成する
パラメータはセミコロンで区切り、 ConnectString の値（接続文字列）
全体を単引用符で囲みます。
ConnectString = 'DSN = data_source_name; {UID = user_ID;
PWD = password; driver_specific_parameters}'
パラメータ
data_source_name
user_ID
password
driver_specific_parameters
説明
データソースの識別名
（オプション）データソースに接続する
ために必要なユーザ ID
（オプション）データソースに接続する
user_ID に対するパスワード
（オプション）接続するために必要なド
ライバ固有のほかのパラメータ
たとえば、 ODBC ドライバによっては、
ここにデータソースディレクトリを指
定します。PB DataDirect Btrieve ODBC ド
ライバを使用している場合、ここに CDB
= 1 を指定すると、 Scalable SQL （以前
の NetWare SQL）データディクショナリ
が存在しないときに、これを新規作成で
きます。
PB DataDirect Text ODBC ドライバは、こ
のパラメータを使用して西暦の最初の
二桁を指定します。 CB = 50 に指定する
と、00 から 49 までの年の接頭辞が「20」、
50 から 99 までの年の接頭辞が「19」に
なります。
デフォルト値
なし
解説
ODBC データソースを定義すると、ConnectString が自動的に作成され、
その値が DB プロファイル設定ダイアログボックスの［プレビュー］
ボックスにコピーされます。この処理は、PowerBuilder からデータソー
スに接続する前に行われます。
接続リファレンス
29
ConnectString
したがって、 ODBC データソースを定義するときに、自分自身で
ConnectString を入力する必要はありません。しかし、 DB プロファイ
ル設定ダイアログボックスで、 ConnectString の値を編集することが必
要になる場合もあります。
DB プロファイル設定ダイアログボックスで編集することによって、
必要に応じて ConnectString パラメータの値を変更できます。たとえば、
既存の ODBC データソースの名前を変更する場合には、データベース
プロファイルを編集して、 ConnectString に新しい DSN （データソース
名）の値を記述します。
例
この例では、データソース名（DSN=Sales）、ユーザ ID（UID=dba）、
パスワード（PWD=sql）を指定する ODBC データソース接続文字列が
示されています。なお、接続文字列を構成するパラメータは、セミコ
ロンで区切られています。
例1
DB プロファイル設定ダイアログボッ
クスの［接続］タブで、［データソース］ドロップダウンリストか
ら「Sales」を選択し、［ユーザ ID］チェックボックスをオンにし
て dba と入力し、［パスワード］チェックボックスをオンにして sql
と入力します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "ConnectString ='DSN=Sales;UID=dba;
PWD=sql'"
この例では、 PB DataDirect Btrieve ODBC ドライバでアクセスす
る Btrieve データソースに対する、接続文字列が示されています。接
続文字列は、 DSN と CDB （Scalable SQL データディクショナリを新規
に作成することを指定します）という、 2 つのパラメータで構成され
ています。なお、接続文字列を構成するパラメータは、セミコロンで
区切られています。
例2
•
DB プロファイル設定ダイアログボッ
クスの［接続］タブの［データソース］ドロップダウンリストか
ら「Btrieve」を選択し、［ドライバ固有のパラメータ］ボックスで、
以下の入力を行います。
データベースプロファイル
CDB=1
•
アプリケーション
コードにこの文を指定するには、以下の入力を
行います。
SQLCA.DBParm = "ConnectString ='DSN=Btrieve;CDB=1'"
30
PowerBuilder
第1章
データベースパラメータの解説
パラメータの追加
ドロップダウンリストに DSN が表示されている場合、 DSN をパ
ラメータに追加する必要はありません。
CursorLib
機能
ODBC データソースと接続するときに、使用するカーソルライブラリ
を指定します。
対象
ODBC（ドライバおよびバックエンド DBMS がサポートしている場合）
構文
CursorLib = 'value'
パラメータ
value
説明
ODBC データソースと接続するときに使用するカーソルライ
ブラリ。以下のいずれかの値を指定します。
• ODBC_Cur_Lib ODBC バージョン 2.0 以上のカーソルライ
ブラリを使用します。
• If_Needed 使用している ODBC ドライバがカーソルをサ
ポートしない場合は、 ODBC バージョン 2.0 以上のカーソ
ルライブラリを使用します。
• Driver_Cursors （デフォルト）データソースのネイティブ
なカーソル機能を使用します。
デフォルト値
CursorLib = 'Driver_Cursors'
例
ODBC データソースと接続するときに、 ODBC バージョン 2.0 以上の
カーソルライブラリを使用することを指定するには以下のようにし
ます。
このステートメントをデータベースプ
ロファイルに指定するには、DB プロファイル設定ダイアログボッ
クスの［トランザクション］タブで［カーソル］の［ライブラリ］
ドロップダウンリストの「カーソルライブラリ」を選択します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "CursorLib='ODBC_Cur_Lib'"
CursorLock
機能
接続リファレンス
CursorScroll パラメータと一緒に使用され、ODBC データソースのカー
ソルに対してロックオプションを指定します。
31
CursorLock
CursorLock パラメータに指定する値によって、以下の 2 つの観点から
カーソルロックを設定できます。
複数のユーザが同一データを同時にアクセスするこ
とを保証します。
•
同時アクセス
•
衝突の検出方法複数のユーザが同一データを同時に更新するとき
に発生する衝突を検出します。
対象
ODBC（ドライバおよびバックエンド DBMS がサポートしている場合）
構文
CursorLock = 'lock_value'
パラメータ
lock_value
説明
ODBC カーソルに対して使用するロックの種類。以下のい
ずれかの値を指定します。
• Lock テーブルの行を更新できる最下位のロックを使
用します。
• Opt オプティミスティック同時実行制御を使用しま
す。つまり、ほかのユーザによるテーブル行の更新処理
はロックされません。衝突を検出するには、行のバー
ジョンやタイムスタンプを比較します。
• OptVal オプティミスティック同時実行制御を使用しま
す。つまり、ほかのユーザによるテーブル行の更新処理
はロックされません。衝突を検出するには、検索された
値と以前の値とを比較します。
• ReadOnly テーブル行は読み出し専用で、行を更新でき
ません。
ODBC 標準におけるロック値の定義については、 ODBC の
マニュアルを参照してください。
デフォルト値
CursorLock パラメータに値が指定されていない場合、 ODBC データ
ソースドライバによって指定されるカーソルロックの設定が、デフォ
ルト値として使用されます。
例
ODBC データソースにおけるカーソルのスクロールとロックオプ
ションを設定するには以下のようにします。
•
DB プロファイル設定ダイアログボッ
クスの［トランザクション］タブで、［スクロールオプション］ド
ロップダウンリストの「動的スクロール」、および［ロック］ド
ロップダウンリストの「オプティミスティック（値）」を選択しま
す。
•
アプリケーション
データベースプロファイル
コードに次のように入力します。
SQLCA.DBParm =
"CursorScroll='Dynamic',CursorLock='OptVal'"
32
PowerBuilder
第1章
関連項目
データベースパラメータの解説
CursorScroll
CursorScroll
機能
CursorLock パラメータと一緒に使用され、 ODBC データソースのカー
ソルに対してスクロールオプションを指定します。
カーソルの位置によって、 SQL 文を実行して取得された結果集合の現
行の位置が示されます。カーソルをスクロールすることによって、結
果集合のデータからデータへ 1 行ずつ移動できます。
対象
ODBC（ドライバおよびバックエンド DBMS がサポートしている場合）
構文
CursorScroll = 'scroll_value'
パラメータ
scroll_value
説明
ODBC カーソルに対して使用するスクロールの種類。以
下のいずれかの値を指定します。
• Forward カーソルは、結果集合の中を前方にだけスク
ロールします。
• Static 結果集合のデータは変更されません。
• KeySet カーソルがキーセット駆動（keyset-driven）で
あることを指定します。キーセット駆動なカーソルが
開くと、ドライバは結果集合全体に対してキーを保存
します。カーソルは結果集合の中をスクロールするた
め、ドライバはこのキーセットの中のキーを使用して、
各行に対する現行の値を取得します。
• Dynamic ドライバは、行セットに指定された行のキー
だけを保存し、使用します。
デフォルト値
CursorScroll パラメータに値が指定されていない場合、 ODBC データ
ソースドライバによって指定されるカーソルスクロールの設定が、デ
フォルト値として使用されます。
解説
結果集合が大きい場合、結果集合全体に対してキーを保存しなければ
ならないキーセット駆動なカーソルを使用することは、実用的ではあ
りません。かわりに、キーセット内の行数を表す 32 ビットの整数値を
指定することによって、複合カーソルを使用することができます（以
下の「例 2」を参照してください）。この値は、通常、結果集合よりも
小さな値です。なお、デフォルトのキーセットサイズは 0 です。
複合カーソルは、指定されたキーセット内では KeySet スクロールを使
用し、キーセット外では Dynamic スクロールを使用します。
例
接続リファレンス
ODBC データソースにおけるカーソルのスクロールとロックオ
プションを設定するには以下のようにします。
例1
33
CursorUpdate
•
DB プロファイル設定ダイアログボッ
クスの［トランザクション］タブで、［スクロールオプション］ド
ロップダウンリストの「動的スクロール」、および［ロック］ド
ロップダウンリストの「オプティミスティック（値）」を選択しま
す。
•
アプリケーション
データベースプロファイル
コードに次のように入力します。
SQLCA.DBParm =
"CursorScroll='Dynamic',CursorLock='OptValue'"
例 2 以下の例は、キーセット内の行数を 100 に設定します。結果集合
全体は 1000 行あるものとします。カーソルが開くと、結果集合の先頭
の 100 行に対してキーが保存されます。続けて、次の 100 キーのブロッ
クが取得され、結果集合全体が取得されるまで処理が続きます。
DB プロファイル設定ダイアログボッ
クスの［トランザクション］タブの［スクロールオプション］ボッ
クスに 100 と入力します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "CursorScroll=100"
関連項目
CursorLock
CursorUpdate
機能
データベースのカーソルが、読み込み専用と更新可能のどちらで宣言
されるかを指定します。
対象
SYC および SYJ Sybase Adaptive Server Enterprise
構文
CursorUpdate = value
パラメータ
value
34
説明
データベースカーソルが、読み込み専用と更新可能のどち
らで宣言されるかを指定する数値。以下のいずれかの値を
指定します。
• 0 （デフォルト）カーソルは読み込み専用で宣言され
ます。 Sybase Client Library のカーソル宣言で、
CS_READ_ONLY オプションをインクルードします。
• 1 カーソルは更新可能で宣言されます。 Sybase Client
Library のカーソル宣言で、 CS_FOR_UPDATE オプショ
ンをインクルードします。このオプションは、テーブル
内の更新可能なすべてのカラムに適用されます。
PowerBuilder
第1章
データベースパラメータの解説
デフォルト値
CursorUpdate = 0
解説
アプリケーションで、以下のいずれかの SQL 文を使用する場合、
CursorUpdate パラメータを 1 に設定して更新可能なカーソルを宣言し
ます。以下のステートメントで、 table はテーブル名を表し、 cursor は
カーソル名を表します。
DELETE FROM table WHERE CURRENT OF cursor
UPDATE table SET set_clause WHERE CURRENT OF cursor
PowerBuilder スクリプトでデータベースと通信している場合は、トラ
ンザクションオブジェクトがデータベースと接続する前と後のどち
らでも、 CursorUpdate の値をリセットできます。
例
データベースカーソルを更新可能で宣言するには以下のようにしま
す。
DB プロファイル設定ダイアログボッ
クスの［トランザクション］タブの［更新可能カーソル］チェッ
クボックスをオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "CursorUpdate=1"
Database
機能
接続するデータベース名を指定します。
Database を指定するタイミング
Database パラメータは、データベースに接続する前に指定します。
対象
ADO.NET
構文
DataBase = 'database_name'
デフォルト値
なし
例
データベース “mydb” に接続するには以下のようにします。
•
DB プロファイル設定ダイアログボッ
クスの［接続］ページの［データベース］ボックスで、 mydb を入
力します。
•
アプリケーション
データベースプロファイル
コードに次のように入力します。
SQLCA.DBParm = "Database='mydb'"
接続リファレンス
35
DataLink
DataLink
機能
データソースに接続するために、接続情報を格納するファイルを作成
するか、既存のファイルを使用するかを指定します。
DataLink を指定するタイミング
DataLink パラメータは、データベースに接続する前に指定します
対象
ADO.NET
OLE DB
構文
DataLink = 'file_name'
デフォルト値
なし
解説
DataLink オプションを使用すると、Microsoft のデータリンク API にア
クセスできます。データリンク API を使用すると、 OLE DB 接続情報
を格納するファイルを定義するか、既存のファイルを使用できます。
データリンクファイルの拡張子は .udl です。
API を起動するには、使用できる DB インタフェースリストの OLE DB
の Utilities の下にある Manage Data Links をダブルクリックするか、DB
プロファイル設定ダイアログボックスの［接続］タブの［ファイル名］
チェックボックスをオンにし、［ファイル名］ボックスの隣のボタンを
クリックします。
データリンク API の使用方法については、 Microsoft 社の Web サイト
「Universal Data Access」を参照してください。
データリンクファイルの使用とデータベースパラメータの設定
データリンクファイルを使用してデータソースに接続する場合、 DB
プロファイル設定ダイアログボックスでの設定はすべて無視されま
す。
例
ファイル oledb.udl を使用して OLE DB データプロバイダに接続する
には以下のようにします。
DB プロファイル設定ダイアログボッ
クスの［接続］タブの［ファイル名］チェックボックスをオンに
し、新しいファイルの名前を入力するか、既存のファイルを選択
します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "DataLink='oledb.udl'"
36
PowerBuilder
第1章
データベースパラメータの解説
DataSource
機能
接続先のデータソースを識別します。データソースには、使用してい
る OLE DB データプロバイダに応じてファイル、データベース、また
は ODBC データソースを指定できます。
DataSource を指定するタイミング
DataSource パラメータは、データベースに接続する前に指定します。
対象
ADO.NET
OLE DB
構文
DataSource = 'datasource_name'
デフォルト値
なし
解説
DataSource パラメータの値は、データソース接続の種類によって異な
ります。たとえば、 Microsoft OLE DB Provider for ODBC を使用してい
る場合は、DataSource 値として実際の ODBC データソース名を入力し
ます。 Microsoft 社の OLE DB Provider for SQL Server を使用している場
合は、 DataSource 値として実際の Microsoft SQL Server サーバ名を入力
します。
詳細については、 OLE DB データプロバイダが提供するマニュアルを
参照してください。
例
Microsoft OLE DB Provider for ODBC を使用して EAS Demo DB に
接続するには以下のようにします。
例1
DB プロファイル設定ダイアログボッ
クスの［接続］タブの［データソース］ボックスに EAS Demo DB
を入力します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "DataSource='EAS Demo DB'"
PB DataDirect OLE DB Provider を使用して Oracle 8 データベース
に接続するには以下のようにします。
例2
•
DB プロファイル設定ダイアログボッ
クスの［接続］タブの［データソース］ボックスにデータソース
名を入力します。事前に、 PB DataDirect OLE DB Administrator を使
用してデータソース名を定義しておく必要があります。
•
アプリケーション
データベースプロファイル
コードに次のように入力します。
SQLCA.DBParm = "DataSource='Oracle8'"
接続リファレンス
37
Date
例 3 Microsoft OLE DB Provider for Oracle を使用して Oracle 8 データ
ベースに接続するには以下のようにします。
•
DB プロファイル設定ダイアログボッ
クスの［接続］タブの［データソース］ボックスに Oracle 8 サー
バ名を入力します。
•
アプリケーション
データベースプロファイル
コードに次のように入力します。
SQLCA.DBParm = "DataSource='Or8server'"
関連項目
DataLink
Provider
Date
機能
データウィンドウペインタでデータを更新するときに、 PowerBuilder
はバックグランドで SQL UPDATE 文を作成します。 Date パラメータ
は、 SQL UPDATE 文で使用する Date データ型の書式を決定します。
対象
JDB JDBC
ODBC
O84 Oracle8i
O90 Oracle9i
O10 Oracle 10g
構文
Date パラメータを指定する構文は、データベースによってわずかに異
なります。
DB プロファイル設定ダイアログボックスで、必要な場所に特殊文字
（引用符と円記号）が挿入されるので、指定するのは Date 型書式だけ
でかまいません。
PowerBuilder アプリケーションのスクリプトでは、以下の構文を使用
する必要があります。
JDBC / ODBC 構文円記号とこれに続く 2 つの単引用符（\''）は、SQL
UPDATE 文が作成されるときには 1 つの単引用符として解析されま
す。
Date = ' \''date_format\'' '
Oracle 構文連続する 4 つの単引用符（''''）は、 SQL UPDATE 文が
作成されるときには 1 つの単引用符として解析されます。
Date = ' ''''date_format'''' '
38
PowerBuilder
第1章
パラメータ
' \''
説明
JDBC / ODBC 構文単引用符、スペース、円記号、
2 つの単引用符の順に指定します。連続する 2 つの
単引用符と、 Date 型書式の間にスペースは入れま
せん。
Oracle 構文単引用符、スペース、 4 つの単引用符
の順に指定します。連続する 4 つの単引用符と、
Date 型書式の間にスペースは入れません。
データウィンドウペインタにおいて、データソー
スを更新するために SQL UPDATE 文を作成すると
きに、 PowerBuilder が使用する Date 型の書式です。
' ''''
date_format
表示書式については、『ユーザーズガイド』マニュ
アルを参照してください。
JDBC / ODBC 構文円記号、2 つの単引用符、スペー
ス、単引用符の順に指定します。 Date 型書式と円
記号の間にスペースは入れません。
Oracle 構文 4 つの単引用符、スペース、単引用符
の順に指定します。 Date 型書式と、 4 つの連続する
単引用符の間にスペースは入れません。
\'' '
'''' '
デフォルト値
データベースパラメータの解説
Date のデフォルト値は、以下の表に示すように、アクセスしている
DBMS によって異なります。
DBMS
JDBC
ODBC
Oracle
デフォルト値
Date データベースパラメータに値が指定されていない場合、レ
ジストリの JDBC ドライバに対応するセクションで Date 型書式
が検索されます。レジストリで Date 型書式が見つからない場合
は、JDBC の Date 型書式エスケープシーケンスが使用されます。
Date データベースパラメータに値が指定されていない場合、
PBODB100 初期設定ファイルの ODBC ドライバに対応するセク
ションで Date 型書式が検索されます。初期設定ファイルの中で
Date 型書式が見つからない場合は、 ODBC の Date 型書式エス
ケープシーケンスが使用されます。
デフォルトの Oracle Date 型書式が使用されます。
詳細については、 Oracle のマニュアルを参照してください。
例
Startdate カラムを 2002-04-23 に設定することによ
り、 Employee という名前のテーブルを更新するものとします。この日
付は、以下の Date 型書式で表されます。
以下の例について
yyyy-mm-dd
接続リファレンス
39
DateFormat
例 1 （JDBC / ODBC 構文） SQL UPDATE 文を作成するときに、この
Date データ型書式を使用することを指定するには以下のようにしま
す。
•
DB プロファイル設定ダイアログボッ
クスの［構文］タブの［Date 型の書式］ボックスで、以下の入力
を行います。
データベースプロファイル
yyyy-mm-dd
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "Date=' \''yyyy-mm-dd\'' '"
作成される SQL UPDATE 文 PowerBuilder は、以下の SQL UPDATE 文
を作成してテーブルを更新します。
UPDATE EMPLOYEE
SET STARTDATE = '2002-04-23'
例 2 （Oracle 構文） SQL UPDATE 文を作成するときに、この Date デー
タ型書式を使用することを指定するには以下のようにします。
•
DB プロファイル設定ダイアログボッ
クスの［構文］タブの［Date 型の書式］ボックスで、以下の入力
を行います。
データベースプロファイル
yyyy-mm-dd
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "Date=' ''''yyyy-mm-dd'''' '"
作成される SQL UPDATE 文 PowerBuilder は、以下の SQL UPDATE 文
を作成してテーブルを更新します。
UPDATE EMPLOYEE
SET STARTDATE = '2002-04-23'
関連項目
DateTime
Time
DateFormat
機能
データウィンドウペインタでデータを更新するときに、 PowerBuilder
はバックグランドで SQL UPDATE 文を作成します。 DateFormat パラ
メータは、SQL UPDATE 文で使用する Date データ型の書式を決定しま
す。
対象
ADO.NET
40
PowerBuilder
第1章
データベースパラメータの解説
OLE DB
構文
DateFormat = 'date_format '
パラメータ
date_format
説明
データウィンドウペインタにおいて、データソー
スを更新するために SQL UPDATE 文を作成すると
きに、 PowerBuilder が使用する Date 型の書式です。
表示書式については、『ユーザーズガイド』マニュ
アルを参照してください。
デフォルト値
DateFormat パラメータに値が指定されていない場合、 Date データ型は
使用されません。
解説
ストアドプロシージャを呼び出した場合、データベースサーバが
PowerBuilder が構築した Date 型書式を受け付けないことがあります。
この場合には、ほかの書式の使用を試してください。たとえば、
Microsoft SQL Server では、次の書式を試してみます。
DateFormat='\''yyyy-mm-dd\'''
例
Startdate カラムを 2002-04-23 に設定することにより、 Employee という
名前のテーブルを更新するものとします。この日付は、 yyyy-mm-dd の
書式で表されます。
SQL UPDATE 文を作成するときに、この Date データ型書式を使用する
ことを指定するには以下のようにします。
•
DB プロファイル設定ダイアログボッ
クスの［構文］タブの［Date 型の書式］ボックスで、以下の入力
を行います。
データベースプロファイル
yyyy-mm-dd
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "DateFormat='yyyy-mm-dd'"
作成される SQL UPDATE 文 PowerBuilder は、以下の SQL UPDATE 文
を作成してテーブルを更新します。
UPDATE EMPLOYEE
SET STARTDATE = '2002-04-23'
関連項目
接続リファレンス
DateTimeFormat
TimeFormat
41
DateTime
DateTime
機能
データウィンドウペインタでデータを更新するときに、 PowerBuilder
はバックグランドで SQL UPDATE 文を作成します。DateTime パラメー
タは、 SQL UPDATE 文で使用する DateTime データ型の書式を決定し
ます（DateTime データ型には日付値と時刻値が両方含まれます）。
対象
JDB JDBC
ODBC
O84 Oracle8i
O90 Oracle9i
O10 Oracle 10g
構文
DateTime パラメータを指定する構文は、データベースによってわずか
に異なります。
DB プロファイル設定ダイアログボックスで、必要な場所に特殊文字
（引用符と円記号）が挿入されるので、指定するのは DateTime 型書式
だけでかまいません。
コードでは、以下の構文を使用する必要があります。
JDBC / ODBC 構文 PowerBuilder は円記号とこれに続く 2 つの単引用
符（\''）は、 SQL UPDATE 文が作成されるときには 1 つの単引用符と
して解析されます。
DateTime = ' \''DateTime_format\'' '
Oracle 構文連続する 4 つの単引用符（''''）は、 SQL UPDATE 文が作
成されるときには 1 つの単引用符として解析されます。
DateTime = ' ''''DateTime_format'''' '
パラメータ
' \''
' ''''
DateTime_format
説明
単引用符、スペース、円記号、 2 つの
単引用符の順に指定します。連続する 2 つの単引用符と、
DateTime 型書式の間にスペースは入れません。
Oracle 構文単引用符、スペース、 4 つの単引用符の順に
指定します。連続する 4 つの単引用符と、 DateTime 型書
式の間にスペースは入れません。
ペインタにおいて、データソースを更新するために SQL
UPDATE 文を作成するときに、 PowerBuilder が使用する
DateTime 型の書式です。
JDBC / ODBC 構文
表示書式については、『ユーザーズガイド』マニュアルを
参照してください。
42
PowerBuilder
第1章
パラメータ
\'' '
説明
JDBC / ODBC 構文円記号、 2 つの単引用符、スペース、
単引用符の順に指定します。 DateTime 型書式と円記号の
間にスペースは入れません。
Oracle 構文 4 つの単引用符、スペース、単引用符の順に
指定します。 DateTime 型書式と、 4 つの連続する単引用
符の間にスペースは入れません。
'''' '
デフォルト値
データベースパラメータの解説
DateTime のデフォルト値は、以下の表に示すように、アクセスしてい
る DBMS によって異なります。
DBMS
JDBC
ODBC
Oracle
デフォルト値
DateTime データベースパラメータに値が指定されていない場
合、レジストリの JDBC ドライバに対応するセクションで
DateTime 型書式が検索されます。レジストリで DateTime 型書式
が見つからない場合は、 JDBC の DateTime 型書式エスケープ
シーケンスが使用されます。
DateTime データベースパラメータに値が指定されていない場
合、 PBODB100 初期設定ファイルの ODBC ドライバに対応する
セクションで DateTime 型書式が検索されます。初期設定ファイ
ルの中で DateTime 型書式が見つからない場合は、 ODBC の
DateTime 型書式エスケープシーケンスが使用されます。
デフォルトの Oracle DateTime 型書式が使用されます。
詳細については、 Oracle のマニュアルを参照してください。
例
Timestamp カラムを 4/2/03 3:45 pm に設定することに
より、 Files という名前のテーブルを更新するものとします。この日付
は、以下の DateTime 型書式で表されます。
以下の例について
m/d/yy h:mm am/pm
SQL UPDATE 文を作成するとき
に、この DateTime データ型書式を使用することを指定するには以下の
ようにします。
例 1 （JDBC / ODBC / OLE DB 構文）
•
DB プロファイル設定ダイアログボッ
クスの［構文］タブの［DateTime 型の書式］ボックスで、以下の
入力を行います。
データベースプロファイル
m/d/yy h:mm am/pm
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "DateTime=' ''m/d/yy h:mm am/pm\'' '"
作成される SQL UPDATE 文 PowerBuilder は、以下の SQL UPDATE 文
を作成してテーブルを更新します。
接続リファレンス
43
DateTimeAllowed
UPDATE FILES
SET TIMESTAMP='4/2/03 3:45 pm'
SQL UPDATE 文を作成するときに、この DateTime
データ型書式を使用することを指定するには以下のようにします。
例 2 （Oracle 構文）
•
DB プロファイル設定ダイアログボッ
クスの［構文］タブの［DateTime 型の書式］ボックスで、以下の
入力を行います。
データベースプロファイル
m/d/yy h:mm am/pm
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="DateTime=' ''''m/d/yy h:mm am/pm''''
'"
作成される SQL UPDATE 文 PowerBuilder は、以下の SQL UPDATE 文
を作成してテーブルを更新します。
UPDATE FILES
SET TIMESTAMP = '4/2/03 3:45 pm'
関連項目
Date
Time
DateTimeAllowed
機能
DateTimeAllowed は、インタフェースがこの機能をサポートしている場
合に、 DateTime データ型書式を持つカラムを SQL UPDATE または
DELETE 文の WHERE 句に固有キーカラムとして表示できるかどうか
を制御します。 PowerBuilder は UPDATE 文または DELETE 文と
INSERT 文を作成して、データウィンドウオブジェクトからデータ
ベースを更新します。
データウィンドウペインタで作業している場合は、更新特性の指定ダ
イアログボックスの［固有キーカラム］リストから選択することに
よって、 WHERE 句にどのカラムを入れるかを指定します。
デフォルトでは、 DateTimeAllowed は 0 に設定され、 DateTime カラム
は［固有キーカラム］リストに表示されないので、 UPDATE または
DELETE 文の WHERE 句には表示できません。DateTimeAllowed を 1 に
設定すると、データベーステーブル内のすべての DateTime カラムが
［固有キーカラム］リストに表示されるので、UPDATE または DELETE
文の WHERE 句で表示されるように選択できます。
44
PowerBuilder
第1章
データベースパラメータの解説
DateTimeAllowed を指定するタイミング
DateTimeAllowed の値は、データベースに接続する前に指定します。
対象
IN9 Informix
SYC Sybase Adaptive Server Enterprise
構文
DateTimeAllowed = value
パラメータ
value
説明
データベースの更新のために PowerBuilder によって作成され
る SQL UPDATE または DELETE 文の WHERE 句で DateTime
カラムを固有キーカラムとして使用できるかどうかを指定す
る値。以下のいずれかの値を指定します。
• 0 （デフォルト） UPDATE または DELETE 文の WHERE 句で
DateTime カラムを使用できません。 DateTimeAllowed を 0
に設定すると、DateTime カラムは更新特性の指定ダイアロ
グボックスの［固有キーカラム］リストに表示されません。
また、'No' または 'False' をこの値に指定することもでき
ます。
• 1 UPDATE または DELETE 文の WHERE 句で DateTime カラ
ムを使用できます。 DateTimeAllowed を 1 に設定すると、
DateTime カラムは更新特性の指定ダイアログボックスの
［固有キーカラム］リストに表示されるので、 WHERE 句で
表示されるように選択できます。また、 'Yes' または
'True' をこの値に指定することもできます。
デフォルト値
DateTimeAllowed = 0
解説
設定が必要な場合データウィンドウオブジェクトからデータベー
スを更新するときに、 UPDATE または DELETE 文の WHERE 句で
DateTime カラムを固有キーカラムとして使用できるようにするには、
DateTimeAllowed を 1 に設定します。
更新特性の指定ダイアログボックスを使ってデータウィンドウオブ
ジェクトの更新特性を指定する際の手順については、『ユーザーズガ
イド』マニュアルの更新の制御についての章を参照してください。
データウィンドウオブジェクトの保存時の処理 DateTimeAllowed を
1 に設定し、 WHERE 句に表示される DateTime カラムを選択してから、
データウィンドウ
オブジェクトを保存すると、以降の接続で
DateTimeAllowed を 0 に設定しても、このカラムはそのまま［固有キー
カラム］リストに表示されるようになります。
例
UPDATE または DELETE 文の WHERE 句で DateTime カラムを使用でき
ます。
接続リファレンス
45
DateTimeFormat
DB プロファイル設定ダイアログボッ
クスの［構文］タブの［DateTime データ型の使用を許可］チェッ
クボックスをオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "DateTimeAllowed=1"
DateTimeFormat
機能
データウィンドウペインタでデータを更新するときに、 PowerBuilder
ではバックグランドで
SQL
UPDATE
文が作成されます。
DateTimeFormat パラメータは、 SQL UPDATE 文で使用する DateTime
データ型の書式を決定します（DateTime データ型には日付値と時刻値
が両方含まれます）。
対象
ADO.NET
OLE DB
構文
DateTimeFormat = 'datetime_format '
パラメータ
datetime_format
説明
データウィンドウペインタにおいて、データソー
スを更新するために SQL UPDATE 文を作成すると
きに、 PowerBuilder が使用する DateTime 型の書式
です。
表示書式については、『ユーザーズガイド』マニュ
アルを参照してください。
デフォルト値
DateTimeFormat パラメータに値が指定されていない場合、 DateTime
データ型は使用されません。
解説
ストアドプロシージャを呼び出した場合、データベースサーバが
PowerBuilder が構築した DateTime 型書式を受け付けないことがありま
す。この場合には、ほかの書式の使用を試してください。例えば、
Microsoft SQL Server では、次の書式を試します。
DateTimeFormat='\''yyyy-mm-dd hh:mm:ss.fff\'''
例
Timestamp カラムを 4/2/03 3:45 pm に設定することにより、Files という
名前のテーブルを更新するものとします。この日付は、以下の DateTime
型書式で表されます。
m/d/yy h:mm am/pm
SQL UPDATE 文を作成するときに、この DateTime データ型書式を使
用することを指定するには以下のようにします。
46
PowerBuilder
第1章
•
データベースパラメータの解説
DB プロファイル設定ダイアログボッ
クスの［構文］タブの［DateTime 型の書式］ボックスで、以下の
入力を行います。
データベースプロファイル
m/d/yy h:mm am/pm
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "DateTimeFormat='m/d/yy h:mm am/pm'"
作成される SQL UPDATE 文 PowerBuilder は、以下の SQL UPDATE 文
を作成してテーブルを更新します。
UPDATE FILES
SET TIMESTAMP = '4/2/03 3:45 pm'
関連項目
DateFormat
TimeFormat
DBGetTime
機能
DBGetTime パラメータは、データウィンドウオブジェクトまたはクエ
リの中で行を検索するときの、 DBMS からの応答待ち時間を秒単位に
指定します。 Async パラメータに 1 を設定して非同期処理を有効にす
る場合、非同期処理をサポートする DBMS に対して、 DBGetTime パラ
メータを設定できます。
DBGetTime の値がデフォルトの 0 に設定されている場合、PowerBuilder
は、 DBMS からの応答を無制限に待ちます。つまり、サーバへのリク
エストはタイムアウトされません。なお、行が最初に取得される前に
DBGetTime パラメータに指定された時間を経過すると、そのリクエス
トは自動的にキャンセルされます。
対象
IN9 Informix
JDB JDBC
ODBC（ドライバおよびバックエンド DBMS がサポートしている場合）
O84 Oracle8i （8.1.5 以降のデータベース接続のみ）
O90 Oracle9i
O10 Oracle 10g
SYC Sybase Adaptive Server Enterprise
構文
DBGetTime = value
パラメータ
value
接続リファレンス
説明
データウィンドウオブジェクト、クエリ、またはレポー
トが最初の行を取得するまでの、 DBMS からの応答待ち
時間です。
47
DBTextLimit
デフォルト値
DBGetTime = 0
解説
DBGetTime を使用するための要件 DBGetTime パラメータを使用す
るためには、以下の両方の操作をします。
例
•
Async パラメータを 1 に設定して、以下の例で示すように、非同期
処理を有効にします。
•
データウィンドウ
オブジェクトまたはレポートに対して
RetrieveRow イベントを指定します。
非同期処理を有効にした上で、DBGetTime パラメータを 20 秒に設定す
るには以下のようにします。
DB プロファイル設定ダイアログボッ
クスの［トランザクション］タブで、［非同期］チェックボックス
をオンにし、［処理待ち時間］ボックスに 20 と入力します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "Async=1,DBGetTime=20"
関連項目
Async
DBTextLimit
機能
SQL Server データベースに接続している状態で、 SQL SELECT 文の中
にテキストフィールドが指定されている場合、 DB-Library™ または
CT-Library が返すテキストフィールドの最大長を指定します。
Blob （binary large object）データ型として扱わずに、データウィンドウ
オブジェクトに長いテキスト文字列を格納したい場合に、 DBTextLimit
パラメータを設定します。
対象
SYC および SYJ Sybase Adaptive Server Enterprise
構文
DBTextLimit = 'value'
パラメータ
value
説明
SQL SELECT 文の中でテキストフィールドが指定されて
いる場合に、 DB-Library または CT-Library が返すテキスト
フィールドの最大長（バイト単位）。0 ～ 32,763 バイトの範
囲の値を指定します。
DBTextLimit に 0 を指定すると、 DB-Library または CTLibrary は最大長のテキストフィールドを返します。
48
PowerBuilder
第1章
データベースパラメータの解説
デフォルト値
DBTextLimit パラメータのデフォルト値は、SQL Server の DBTEXTLIMIT
DB-Library または CS_TEXTLIMIT CT-Library 接続プロパティで指定さ
れるデフォルト値になります。詳細については、 SQL Server のマニュ
アルを参照してください。
解説
DB-Library または CT-Library が返すテキストフィールドの長さは、
DBTextLimit 値と、 SQL Server グローバル変数 @@textsize の設定の、
どちらか小さい方の値に相当します。
@@textsize の設定の方が DBTextLimit に指定した値より小さい場合、
DB-Library または CT-Library は @@textsize の値を返します。
例
SQL SELECT 文にテキストフィールドが指定されている場合、 DBLibrary または CT-Library が返すテキストフィールドの長さが最大で
32,000 バイトであることを指定するには以下のようにします。
•
DB プロファイル設定ダイアログボッ
クスの［構文］タブの［テキストの最大値］ボックスに 32000 と
入力します。
•
アプリケーション
データベースプロファイル
コードに次のように入力します。
SQLCA.DBParm = "DBTextLimit='32000'"
DecimalSeparator
機能
PowerBuilder からアクセスしているバックエンド DBMS が使用する、
小数点記号を指定します。デフォルトであるピリオド（.）以外の小数
点記号を DBMS で使用している場合、データベースから返される数値
文字列を PowerBuilder で正しく処理できるように、 DBMS に合わせた
値を DecimalSeparator に設定します。
対象
ADO.NET
ODBC（ドライバおよびバックエンド DBMS がサポートしている場合）
OLE DB
O84 Oracle8i
O90 Oracle9i
O10 Oracle 10g
構文
DecimalSeparator = 'value'
接続リファレンス
49
DecimalSeparator
パラメータ
value
説明
PowerBuilder からアクセスしているバックエンド DBMS が
使用する、小数点記号。以下のいずれかの値を指定します。
• '.' （デフォルト）バックエンド DBMS が、小数点記号と
してピリオド（.）を使用することを指定します。
DecimalSeparator パラメータを指定しなかった場合、また
はピリオド（.）やカンマ（,）以外の値を指定した場合、
小数点記号としてピリオド（.）が使用されます。
• ',' バックエンド DBMS が、小数点記号としてカンマ（,）
を使用することを指定します。
デフォルト値
DecimalSeparator = '.'
解説
DecimalSeparator の指定が必要な場合 DecimalSeparator パラメータの
値としては、現在のところ、ピリオド（.）とカンマ（,）が有効です。
したがって、アクセスしている DBMS における小数点記号の設定がカ
ンマの場合は、 DecimalSeparator パラメータを ',' （カンマ）に設定す
ることによって、データベースから返される数値文字列を
PowerBuilder が正しく処理できるようにします。
Oracle の例 PowerBuilder から Oracle データベースにアクセスしてい
て、小数点記号の設定はカンマ（,）であるものとします。 Oracle から
PowerBuilder に返される '123,50' という数値文字列の小数点記号は、ピ
リオドではなくカンマです。 PowerBuilder はこの文字列を、自身の十
進変換ルーチンに送ります。
デフォルトでは、 PowerBuilder の十進変換ルーチンは、ピリオドを小
数点記号として処理します。 DecimalSeparator パラメータを ',' （カン
マ）に設定することによって、 PowerBuilder はこの文字列を正しく処
理し、 '123,50' として返すことができます。
例
アクセスしている DBMS が、小数点記号としてカンマ（,）を使用する
ことを指定するには以下のようにします。
DB プロファイル設定ダイアログボッ
クスの［構文］タブの［小数点の記号］ボックスに、カンマ（,）
を入力します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "DecimalSeparator=','"
関連項目
50
NumericFormat
PowerBuilder
第1章
データベースパラメータの解説
DefaultProcOwner
機能
DefaultProcOwner パラメータにより、ストアドプロシージャのデフォ
ルトオーナを設定できます。このパラメータは、ストアドプロシー
ジャが修飾されないときに限って有効となります。 ODBC の場合、
PBNewSPInvocation パラメータも設定する必要があります。
対象
ADO.NET
ODBC
構文
DefaultProcOwner='value'
パラメータ
value
解説
説明
ストアドプロシージャのデフォルトのオーナ名を指定す
る文字列です。
このパラメータはデータベース接続後、実行時に動的に設定できます。
データウィンドウペインタのストアドプロシージャデータソース
で、データを作成したりデータウィンドウに取得したりする場合は、
PBODB100.INI ファイルに設定することもできます。実行時の設定が
PBODB100.INI の設定よりも優先されます。
実行時に設定をキャンセルすることも可能です。これを行った場合、
PowerBuilder は、ストアドプロシージャのパラメータを取得すると、
修飾していないストアドプロシージャのオーナとして現行のユーザ
を使用します。
例
PBODB100.INI の proms にデフォルトのオーナを設定するには、以下
のようにします。
[Adaptive Server Anywhere]
DefaultProcOwner='proms'
以下のコードで、
SQLCA.DBParm="DefaultProcOwner='proms'";
設定をキャンセルするには、以下のようにします。
SQLCA.DBParm="DefaultProcOwner=''";
前の例の単引用符には、スペースではなく空の文字列が含まれていま
す。
関連項目
接続リファレンス
PBNewSPInvocation
51
DelimitIdentifier
DelimitIdentifier
機能
SQL 文を作成するときに、テーブル名、カラム名、インデックス名、
制約名を二重引用符で囲むかどうかを指定します。この設定は、 SQL
文を作成する PowerBuilder のペインタの動作に影響します。
対象
ADO.NET
Informix 9
JDB JDBC
ODBC（ドライバおよびバックエンド DBMS がサポートしている場合）
OLE DB
O84 Oracle8i
O90 Oracle9i
O10 Oracle 10g
SYC Sybase Adaptive Server Enterprise
構文
DelimitIdentifier = 'value'
パラメータ
value
デフォルト値
説明
PowerBuilder において、テーブルやカラムの名前を二重引用符
で囲むかどうかを指定する値。以下のいずれかの値を指定しま
す。
• Yes テーブル名やカラム名を二重引用符で囲みます。
• No テーブル名やカラム名を二重引用符で囲みません。
DelimitIdentifier パラメータのデフォルト値は、以下の表に示すように、
アクセスしている DBMS によって異なります。
DBMS
ADO.NET
Informix
JDBC
ODBC
Oracle
OLE DB
Sybase Adaptive Server
Enterprise
52
DelimitIdentifer パラメータのデフォルト値
DelimitIdentifier = 'No'
DelimitIdentifier = 'No'
レジストリの DelimitIdentifer 設定に依存
PBODB100 初期設定ファイルの DelimitIdentifer 設定
に依存
DelimitIdentifier = 'Yes'
DelimitIdentifier = 'Yes'
DelimitIdentifier = 'No'
PowerBuilder
第1章
解説
データベースパラメータの解説
Informix Informix データベースサーバでは、 ASCII または非 ASCII の
いずれかの書式でデータベーストランザクションのログを作成できま
す。データベースで非 ASCII ログを作成している場合、 DelimitIdentifier
の設定はオプションです。データベースで ASCII ログを作成している
場合、 PowerBuilder によって生成される SQL 構文を想定通りに動作さ
せるには、 DelimitIdentifier = 'Yes' を設定する必要があります。
Sybase Adaptive Server Enterprise DelimitIdentifier を 'Yes' に設定する
と、“set quoted_identifier on” コマンドが自動的に Adaptive Server に送信
され、サーバでのデータベース接続を調整します。そうでなければ、
“set quoted_identifier off” コマンドがサーバに送信されます。この機能
は SYC、 JDBC、および ODBC インタフェースで発生します。
Microsoft SQL Server DelimitIdentifier を 'Yes' に設定すると、 OLE DB
インタフェースを使用しているときに “set quoted_identifier on” コマン
ドが自動的に Microsoft SQL Server に送信され、サーバでのデータベー
ス接続を調整します。それ以外のインタフェースを使用している場合
は、 “set quoted_identifier off” コマンドがサーバに送信されます。
JDBC および ODBC DelimitIdentifier パラメータの設定は、レジスト
リで JDBC ドライバに対して指定されている DelimitIdentifier の設定、
および PBODB100 初期設定ファイルの中で ODBC ドライバに対して
指定されている DelimitIdentifier の設定より優先されます。
例
PowerBuilder が SQL 文を作成するときに、テーブル名とカラム名を二
重引用符で囲まないことを指定するには以下のようにします。
•
DB プロファイル設定ダイアログボッ
クスの［構文］タブの［テーブル名およびカラム名を引用符で囲
む］チェックボックスをオフにします。
•
アプリケーション
データベースプロファイル
コードに次のように入力します。
SQLCA.DBParm = "Delimitidentifier='No'"
DisableBind
機能
バインド変数をサポートする DBMS に対して、 PowerBuilder はデフォ
ルトで、コンパイル済みの SQL 文に入力パラメータをバインドしま
す。 DisableBind パラメータを使用すると、このデフォルトの変数バイ
ンドを禁止できます。
DisableBind パラメータに 1 を設定するとバインドが禁止され、入力変
数は、アプリケーションユーザによって入力された値またはコードに
指定された値に置き換えられます。
接続リファレンス
53
DisableBind
対象
ADO.NET
Informix 9
JDB JDBC
ODBC（ドライバおよびバックエンド DBMS がサポートしている場合）
OLE DB
O84 Oracle8i
O90 Oracle9i
O10 Oracle 10g
構文
DisableBind = value
パラメータ
value
説明
コンパイル済みの SQL 文に対して、入力パラメータのデ
フォルトバインドを禁止するかどうかを指定する値。以下
のいずれかの値を指定します。
• 0 コンパイル済みの SQL 文に対して、入力パラメータ
をバインドします。
• 1 コンパイル済みの SQL 文に対して、入力パラメータ
をバインドしません。
デフォルト値
ADO.NET と OLE DB に対しては DisableBind = 1、ほかのインタフェー
スに対しては DisableBind=0
解説
バインド変数 SQL 文において、バインド変数はカラム値のプレース
ホルダーとして使用されます。デフォルトでは、 PowerBuilder は SQL
文を実行するたびに、アプリケーションで定義された変数からデータ
をバインド変数に関連付け（バインド）します。
SQL 文の中でのバインド変数の使い方たとえば、以下の SQL 文は、
Books テーブルから Hemingway によって書かれた書籍に関する行を取
得します。
SELECT * FROM books WHERE author = "Hemingway"
このステートメントを実行して、ほかの著者が執筆した書籍に関する
情報を取得するものとします。著者ごとに SQL 文をコンパイルして実
行するかわりに、著者名を表わすバインド変数を定義することができ
ます。これによって、エンドユーザは、アプリケーションを実行する
ときに、著者の名前を指定することになります。バインド変数を使用
すると、 SQL 文を 1 回コンパイルするだけで、エンドユーザが指定す
る新しい値で繰り返しこれを実行することができます。
54
PowerBuilder
第1章
データベースパラメータの解説
使用するデータベースがバインド変数をサポートしていて、かつ、
DisableBind パラメータが 0 に設定されバインドが許可されている場合
（ADO.NET および OLE DB を除くすべてのデータベースインタ
フェースのデフォルト）、 PowerBuilder はパラメータマーカー
（:bind_param）のある SQL 文を作成し、実行時に実際のパラメータ値
を渡します。この例を以下に示します。
SELECT * FROM books WHERE author = :bind_param
DataDirect ODBC ドライバの使用
Sybase Adaptive Server Enterprise の DataDirect ワイヤプロトコルドライ
バは、 DisableBind 機能をサポートするのに必要な SQL describe パラ
メータ関数をサポートしません。このドライバを使用する場合は、
DisableBind=0 の設定は無効です。
バインド変数とキャッシュ文キャッシュ文とバインド変数を同時に
使用すると、ほとんどのアプリケーションの実行速度を改善すること
ができます。改善の程度はアプリケーションごとにそれぞれ異なりま
す。一般に、大量のトランザクションを処理するアプリケーションほ
ど、バインド変数とキャッシュ文が効果を発揮します。
キャッシュ文を使用するには、 DisableBind パラメータを 0 （デフォル
ト）に設定します。これによって、 PowerBuilder における、 SQL 文へ
の入力変数のバインドが許可されます。キャッシュ文については、
SQLCache パラメータについての解説を参照してください。
パフォーマンスの向上 Adaptive Server Anywhere や Oracle データベー
スに対して、 PowerBuilder で 255 文字を超える文字列の修正や挿入を
許可する場合、バインド変数によるパフォーマンスの改善が見られま
す。
バインド変数とデフォルトのカラム値 DisableBind パラメータが 0 に
設定され、バインド変数を使用することが許可されると、データウィ
ンドウペインタは以下の処理を両方とも実行します。これによって、
データウィンドウオブジェクトに行を追加するとき、バインド変数を
使用することでパフォーマンスが最大限に改善されます。
接続リファレンス
•
すべてのカラム（identity カラムや SQL Server timestamp カラムは
除く）がある SQL INSERT 文を作成します。
•
データウィンドウオブジェクトに追加する行ごとに、この SQL
INSERT 文を繰り返し使用します。
55
DisableBind
たとえば、 Order_T という名前のテーブルに、 Order_ID、 Order_Date、
Customer_ID という 3 つのカラムが含まれる場合、 DisableBind パラ
メータが 0 に設定される（デフォルトバインドが許可される）と、デー
タウィンドウペインタによって以下の SQL INSERT 文が作成されま
す。
INSERT INTO Order_T(Order_ID, Order_Date, Customer_ID)
VALUES(:bind_param1, :bind_param2, :bind_param3)
いずれかのカラムが NULL 値の場合、データウィンドウペインタはこ
のカラムパラメータに NULL 値インジケータを設定し、SQL 文を実行
します。バックエンド DBMS に対して、データウィンドウオブジェク
ト内のカラムにデフォルト値を設定することが望まれる場合、この動
作はきわめて重要な意味を持ちます。
たとえば、バックエンド DBMS が Order_Date カラムに TODAY という
デフォルト値を設定することを期待して、アプリケーションユーザが
このカラムに値を入力しなかった場合を考えます。この後、行を取得
すると、 Order_Date カラムにはデフォルト値ではなく、 NULL 値が設
定されていることが判明します。これは、データウィンドウペインタ
で作成された SQL INSERT 文が NULL 値インジケータを指定したため
に発生した現象で、 DBMS は、カラム値を期待されたデフォルト値で
はなく、 NULL 値に設定します。
バインドが許可されている状態でのデフォルトカラム値の設定
バ
インド変数を使用している（DisableBind パラメータが 0 に設定されて
いる）状態で、アプリケーションユーザが新しい行に値を明示的に入
力しなかったとき、バックエンド DBMS がそのデフォルト値を設定す
るためには、そのカラムの DBMS デフォルト値に等しい初期値を、
データウィンドウオブジェクトカラムに設定します。
データウィンドウペインタでは、カラムの仕様ダイアログボックス
で、カラムの初期値の設定や変更ができます。
カラムの仕様ダイアログボックスの詳細については、『ユーザーズガ
イド』マニュアルを参照してください。
バインドが禁止されている状態でのデフォルトカラム値の設定バ
インド変数を使用していない（DisableBind パラメータが 1 に設定され
ている）状態で、アプリケーションユーザが新しい行に値を明示的に
入力しなかったとき、バックエンド DBMS がそのデフォルト値を設定
するために、データウィンドウカラムに初期値を設定する必要はあり
ません。
56
PowerBuilder
第1章
データベースパラメータの解説
これは、バインド変数が禁止されている場合、データウィンドウペイ
ンタは、データウィンドウオブジェクトに追加される行ごとに、 SQL
INSERT 文を作成するためです。カラムが明示的な値を持たない場合、
それは SQL INSERT 文に含まれません。
Order_T テーブルの例において、アプリケーションユーザが Order_ID
カラムの値として 123、Customer_ID カラムの値として A-123 を入力す
ると、 DisableBind パラメータが 1 に設定されている（バインドが禁止
されている）場合、データウィンドウペインタは以下の SQL INSERT
文を作成します。
INSERT INTO Order_T(Order_ID, Customer_ID)
VALUES(123, 'A-123')
バックエンド DBMS は、 Order_Date カラムを、期待どおりにそのデ
フォルト値に設定します。これは、 Order_Date の値が、データウィン
ドウペインタによって作成される SQL INSERT 文で、明示的に設定さ
れないためです。
例
コンパイル済みの SQL ステートメントへの、入力パラメータのバイン
ドを禁止するには以下のようにします。
DB プロファイル設定ダイアログボッ
クスの［トランザクション］タブまたは［システム］タブの［バ
インドの抑制］チェックボックスをオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "DisableBind=1"
関連項目
SQLCache
DisableUnicode
機能
データベースから取得するデータが ANSI か Unicode のどちらである
かを指定します。ユーロ記号のような文字を正しく変換できない文字
設定をクライアント側で行っている場合に、このパラメータを使用し
ます。
対象
O84 Oracle8i
構文
DisableUnicode = value
接続リファレンス
57
Driver
パラメータ
value
説明
データベースから取得するデータが ANSI か
Unicode のどちらであるかを指定する。以下のいずれ
かの値を指定します。
0 PowerBuilder はデータを Unicode として取得
• 1 PowerBuilder はデータを ANSI として取得
•
デフォルト値
DisableUnicode =0
解説
クライアントの環境設定が、ユーロ記号のような特別な文字を含んで
いる WE8ISO8859P15 のような文字セットを使用している場合、
Oracle8i データベースから検索されたときに正しく変換されません。
O84 ドライバは、デフォルトではデータベースから Unicode 文字を検
索するため、この文字設定ではユーロ記号は有効な Unicode 文字とは
認識されません。
DisableUnicode データベースパラメータを使用すると、データベース
から Unicode 文字でなく ANSI 文字を検索することができます。検索
された ANSI 文字は、その後 Unicode 文字列に変換されます。
例
PowerBuilder がデータベースから ANSI 文字を検索するように指定す
るには、以下のようにします。
Oracle8i の DB プロファイル設定ダイ
アログボックスの［接続］タブで［Unicode サポートを無効］チェッ
クボックスを選択します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "DisableUnicode=1"
Driver
機能
アプリケーションがデータベースに接続するために使用する JDBC ド
ライバです。
Driver を指定するタイミング
Driver データベースパラメータは、データベースに接続する前に指定
します。
対象
JDB JDBC
構文
Driver = 'driver_name'
58
PowerBuilder
第1章
データベースパラメータの解説
デフォルト値
なし
解説
ドライバ名は、データベースに接続するために使用している特定のド
ライバの Java クラス名を識別します。
例
例1
Sybase jConnect ドライバのドライバ名を設定するには以下のよ
うにします。
•
DB プロファイル設定ダイアログボッ
クスの［接続］タブの［ドライバ名］ボックスで以下の入力を行
います。
データベースプロファイル
com.sybase.jdbc.SybDriver
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "Driver =
'com.sybase.jdbc.SybDriver'"
Oracle JDBC ドライバのドライバ名を設定するには以下のように
します。
例2
•
DB プロファイル設定ダイアログボッ
クスの［接続］タブの［ドライバ名］ボックスで以下の入力を行
います。
データベースプロファイル
oracle.jdbc.driver.OracleDriver
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "Driver =
'oracle.jdbc.driver.OracleDriver'"
関連項目
URL
DS_Alias
機能
DS_Alias は、 PowerBuilder から Open Client を経由して Sybase Adaptive
Server Enterprise データベースにアクセスするときに、アプリケーショ
ンでネットワークベースのディレクトリサービスを有効にするため
に設定できるパラメータのうちの 1 つです。ほかのディレクトリサー
ビスパラメータについては、「関連項目」を参照してください。
一部のディレクトリサービスプロバイダおよびドライバは、エリアス
エントリの作成をサポートしています。エリアスエントリは、階層内
のプライマリディレクトリエントリへのリンクを提供し、特定のネッ
トワークエンティティを探してディレクトリ構造を検索するときに、
ユーザが複数の方法でプライマリエントリへアクセスできるように
します。
接続リファレンス
59
DS_Alias
DS_Alias は、ディレクトリサービスプロバイダおよびドライバがエリ
アスをサポートしている場合、ディレクトリ階層の検索時に、プロバ
イダがエリアスエントリに対するリンクをたどる（エリアスエントリ
を展開する）ことができるようにするかどうかを指定します。デフォ
ルト動作では、この機能をサポートしているプロバイダはエリアスエ
ントリを展開できます。
DS_Alias パラメータは、 PowerBuilder からデータベースに接続する前
に指定します。
サードパーティのディレクトリサービスプロバイダの使用
Sybase が Open Client ディレクトリサービスでテストを行ったサード
パーティのディレクトリサービスプロバイダおよびオペレーティン
グシステムプラットフォームの詳細については、Open Client のドキュ
メントを参照してください。
対象
SYC Sybase Adaptive Server Enterprise
構文
DS_Alias = value
パラメータ
value
説明
ディレクトリサービスプロバイダおよびドライバがエリアス
をサポートしている場合、ディレクトリ階層の検索時に、プ
ロバイダがエリアスエントリを展開できるかどうかを指定す
る値。以下のいずれかの値を指定します。
• 0 ディレクトリ検索時に、プロバイダはエリアスエントリ
を展開できません。また、 'No' または 'False' をこの値に
指定することもできます。
• 1 （デフォルト）ディレクトリ検索時に、プロバイダはエ
リアスエントリを展開できます。また、 'Yes' または
'True' をこの値に指定することもできます。
デフォルト値
DS_Alias = 1
解説
設定が必要な場合ディレクトリエリアスエントリを通じてデータ
にアクセスできないようにするには、 DS_Alias を 0 に設定します。こ
の設定により、エリアスをサポートしているディレクトリサービスプ
ロバイダはディレクトリ検索時にエリアスエントリを展開できなく
なります。
Release パラメータの設定このパラメータを有効にするには、Release
パラメータに 11 以上を設定して、アプリケーションが適切なバージョ
ンの Sybase Open Client Client-Library （CT-Lib）の動作を使用すること
を指定する必要があります。詳細については、 Release パラメータの説
明を参照してください。
60
PowerBuilder
第1章
データベースパラメータの解説
使用のための要件 DS_Alias または、Open Client ディレクトリサービ
スをサポートしているほかのパラメータを使用するには、PowerBuilder
アプリケーションでディレクトリサービスを使用するための一定の
要件を満たしている必要があります。詳細については、『データベース
との接続』マニュアルの「Open Client のディレクトリサービスを使用
するための条件」を参照してください。
対応する CT-Lib 接続プロパティ DS_Alias に値を指定すると、
CS_DS_EXPANDALIAS という名前の、対応する Sybase CT-Lib 接続プ
ロパティが設定されます。
例
エリアスをサポートしているディレクトリサービスプロバイダが
ディレクトリ検索時にエリアスエントリを展開できないようにする
には、以下のようにします。
DB プロファイル設定ダイアログボッ
クスの［ディレクトリサービス］タブの［ディレクトリエイリア
スエントリ］チェックボックスをオフにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "DS_Alias=0"
関連項目
DS_Copy
DS_DitBase
DS_Failover
DS_Password
DS_Principal
DS_Provider
DS_TimeLimit
Release
DS_Copy
機能
DS_Copy は、 PowerBuilder から Open Client を経由して Sybase Adaptive
Server Enterprise データベースにアクセスするときに、アプリケーショ
ンでネットワークベースのディレクトリサービスを有効にするため
に設定できるパラメータのうちの 1 つです。ほかのディレクトリサー
ビスパラメータについては、「関連項目」を参照してください。
一部のディレクトリサービスプロバイダおよびドライバは、キャッシ
ングの使用をサポートしています。キャッシングは、ディレクトリ検
索時に、ディレクトリサービスプロバイダが、ディレクトリサーバ
エージェントに対して情報を要求するかわりに、キャッシュされてい
る情報を使用できるようにします。
接続リファレンス
61
DS_Copy
DS_Copy は、ディレクトリサービスプロバイダおよびドライバが
キャッシングをサポートしている場合、ディレクトリ検索時にプロバ
イダがキャッシュされている情報を使用できるようにするかどうかを
指定します。デフォルト動作では、この機能をサポートしているプロ
バイダはキャッシュされている情報を使用できます。
DS_Copy パラメータは、 PowerBuilder からデータベースに接続する前
に指定します。
サードパーティのディレクトリサービスプロバイダの使用
Sybase が Open Client ディレクトリサービスでテストを行ったサード
パーティのディレクトリサービスプロバイダおよびオペレーティン
グシステムプラットフォームの詳細については、Open Client のドキュ
メントを参照してください。
対象
SYC Sybase Adaptive Server Enterprise
構文
DS_Copy = value
パラメータ
value
説明
ディレクトリサービスプロバイダおよびドライバが
キャッシングをサポートしている場合、ディレクトリ検索
時にドライバがキャッシュされている情報を使用できるか
どうかを指定する値。以下のいずれかの値を指定します。
• 0 プロバイダはディレクトリ検索時にキャッシュされ
ている情報を使用できません。また、'No' または 'False'
をこの値に指定することもできます。
• 1 （デフォルト）プロバイダはディレクトリ検索時に
キャッシュされている情報を使用できます。また、'Yes'
または 'True' をこの値に指定することもできます。
デフォルト値
DS_Copy = 1
解説
設定が必要な場合ディレクトリ検索時に、プロバイダがキャッシュ
されている情報を使用できるようにすると、検索処理をより高速に行
えます。ただしその場合、プロバイダが最新のディレクトリ情報を使
用しているかどうかは保証されません。
最新のディレクトリエントリの変更をアプリケーションが取得する
ことが保証されるようにするには、 DS_Copy を 0 に設定して、キャッ
シングをサポートしているプロバイダがディレクトリ検索時にキャッ
シュされている情報を使用できないようにします。
62
PowerBuilder
第1章
データベースパラメータの解説
Release パラメータの設定このパラメータを有効にするには、Release
パラメータに 11 以上を設定して、アプリケーションが適切なバージョ
ンの Sybase Open Client Client-Library （CT-Lib）の動作を使用すること
を指定する必要があります。詳細については、 Release パラメータの説
明を参照してください。
使用のための要件 DS_Copy または、Open Client ディレクトリサービ
スをサポートしているほかのパラメータを使用するには、PowerBuilder
アプリケーションでディレクトリサービスを使用するための一定の
要件を満たしている必要があります。詳細については、『データベース
との接続』マニュアルの「Open Client のディレクトリサービスを使用
するための条件」を参照してください。
対応する CT-Lib 接続プロパティ DS_Copy に値を指定すると、
CS_DS_COPY という名前の、対応する Sybase CT-Lib 接続プロパティ
が設定されます。
例
キャッシングをサポートしているディレクトリサービスプロバイダ
がディレクトリ検索時にキャッシュされている情報を使用できないよ
うにするには、以下のようにします。
DB プロファイル設定ダイアログボッ
クスの［ディレクトリサービス］タブの［キャッシュの使用］チェッ
クボックスをオフにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "DS_Copy=0"
関連項目
接続リファレンス
DS_Alias
DS_DitBase
DS_Failover
DS_Password
DS_Principal
DS_Provider
DS_TimeLimit
Release
63
DS_DitBase
DS_DitBase
機能
DS_DitBase は、 PowerBuilder から Open Client を経由して Sybase
Adaptive Server Enterprise データベースにアクセスするときに、アプリ
ケーションでネットワークベースのディレクトリサービスを有効に
するために設定できるパラメータのうちの 1 つです。ほかのディレク
トリサービスパラメータについては、「関連項目」を参照してくださ
い。
Open Client ディレクトリサービスを使用するときには、Open Client/Server™
Configuration ユーティリティで、デフォルトの（アクティブな）ディ
レクトリ情報ツリーベース（DIT ベース）が指定されます。 DIT ベー
スは、ディレクトリ検索が開始されるディレクトリノードです。 MSDOS ファイルシステムの現行の作業ディレクトリに似ています。
DS_DitBase を使うと、ディレクトリエントリの検索を開始するディレ
クトリノードの名前を指定できます。指定する DS_DitBase 値は、ディ
レクトリサービスプロバイダおよびドライバで要求される構文を
使った絶対パス名でなければなりません（以下の「例」を参照）。
DS_DitBase のデフォルト値は、 Open Client/Open Server Configuration
ユーティリティで現在アクティブに指定されている DIT ベースです。
DS_DitBase パラメータは、 PowerBuilder からデータベースに接続する
前に指定します。
サードパーティのディレクトリサービスプロバイダの使用
Sybase が Open Client ディレクトリサービスでテストを行ったサード
パーティのディレクトリサービスプロバイダおよびオペレーティン
グシステムプラットフォームの詳細については、Open Client のドキュ
メントを参照してください。
対象
SYC Sybase Adaptive Server Enterprise
構文
DS_DitBase = 'dit_base'
64
PowerBuilder
第1章
パラメータ
dit_base
データベースパラメータの解説
説明
ディレクトリ検索を開始するディレクトリノードの名前。
デフォルトでは、Open Client/Open Server Configuration ユー
ティリティで現在アクティブに指定されている DIT ベー
スです。
dit_base の値は、ディレクトリサービスプロバイダおよ
びドライバで要求される構文を使った絶対パス名でなけ
ればなりません。DIT ベースを指定するための構文はプロ
バイダによって異なります。詳細については、プロバイダ
のマニュアルを参照してください。
さまざまなディレクトリサービスプロバイダに対して
dit_base を指定する方法については、以下の「例」を参照
してください。
デフォルト値
DS_DitBase のデフォルト値は、 Open Client/Open Server Configuration
ユーティリティで現在アクティブに指定されている DIT ベースです。
解説
設定が必要な場合 DS_DitBase は、ディレクトリ検索の開始ノードを
Open Client/Open Server Configuration ユーティリティでアクティブに指
定されている DIT ベースノード以外のノードに指定するときに設定
します。 Open Client/Open Server Configuration ユーティリティの使い方
については、 Sybase Open Client/Server の『設定ガイド』マニュアルを
参照してください。
Release パラメータの設定このパラメータを有効にするには、Release
パラメータに 11 以上を設定して、アプリケーションが適切なバージョ
ンの Sybase Open Client Client-Library （CT-Lib）の動作を使用すること
を指定する必要があります。詳細については、 Release パラメータの説
明を参照してください。
使用のための要件 DS_DitBase または、Open Client ディレクトリサー
ビスをサポートしているほかのパラメータを使用するには、
PowerBuilder アプリケーションでディレクトリサービスを使用するた
めの一定の要件を満たしている必要があります。詳細については、
『データベースとの接続』マニュアルの「Open Client のディレクトリ
サービスを使用するための条件」を参照してください。
対応する CT-Lib 接続プロパティ DS_DitBase に値を指定すると、
CS_DS_DitBase という名前の、対応する Sybase CT-Lib 接続プロパティ
が設定されます。
例
接続リファレンス
以下の例は、さまざまなディレクトリサービスプロ
バイダで DS_DitBase 値を指定する方法を示します。
以下の例について
65
DS_DitBase
使用しているディレクトリサービスプロバイダで要求される DIT
ベースを指定するための形式については、ディレクトリサービスプロ
バイダのマニュアルを参照してください。
以下の例は、ディレクトリサービスプ
ロバイダが Windows NT レジストリである場合の DS_DitBase の構文を
示します。
Node name: SALES:software\sybase\server\SYS11NT
DS_DitBase: SALES:software\sybase\server
例 1 （Windows NT レジストリ）
DS_DitBase を設定するには、以下のようにします。
•
DB プロファイル設定ダイアログボッ
クスの［ディレクトリサービス］タブの［DIT ベース］ボックス
で、以下の入力を行います。 DS_DitBase の値は、円記号（\）で終
わっていてはなりません。
データベースプロファイル
SALES:software\sybase\server
•
アプリケーションコードに次のように入力します。 DS_DitBase の
値は、円記号（\）で終わっていてはなりません。
SQLCA.DBParm =
"DS_DitBase='SALES:software\sybase\server'"
以下の例は、ディレクトリサービスプロバイダが
Distributed Computing Environment Cell Directory Services （DCE/CDS）で
ある場合の DS_DitBase の構文を示します。
Node name: /.../boston.sales/dataservers/sybase/SYS11
DS_DitBase: /.../boston.sales/dataservers
例 2 （DCE/CDS）
DS_DitBase を設定するには、以下のようにします。
•
DB プロファイル設定ダイアログボッ
クスの［ディレクトリサービス］タブの［DIT ベース］ボックス
で、以下の入力を行います。 DS_DitBase の値は、スラッシュ（/）
で終わっていてはなりません。
データベースプロファイル
/.../boston.sales/dataservers
•
アプリケーションコードに次のように入力します。 DS_DitBase の
値は、スラッシュ（/）で終わっていてはなりません。
SQLCA.DBParm ="DS_DitBase =
'/.../boston.sales/dataservers'"
以下の例は、ディレクトリサービスプロバイダ
が Banyan StreetTalk Directory Assistance （STDA）である場合の
DS_DitBase の構文を示します。
例 3 （Banyan STDA）
66
PowerBuilder
第1章
データベースパラメータの解説
Node name: SYS11@sales@chicago
DS_DitBase: chicago
DS_DitBase を設定するには、以下のようにします。
•
DB プロファイル設定ダイアログボッ
クスの［ディレクトリサービス］タブの［DIT ベース］ボックス
で、以下の入力を行います。 DS_DitBase の値は、 @ から始めては
なりません。
データベースプロファイル
chicago
•
アプリケーション以下の入力を行います。 DS_DitBase の値は、 @
から始めてはなりません。
SQLCA.DBParm = "DS_DitBase = 'chicago'"
例 4 （Novell NDS）以下の例は、ディレクトリサービスプロバイダが
Novell NetWare Directory Services （NDS）である場合の DS_DitBase の
構文を示します。
Node name: CN=SYS11.OU=miami.OU=sales.O=sybase
DS_DitBase: OU=miami.OU=sales.O=sybase
DS_DitBase を設定するには、以下のようにします。
•
DB プロファイル設定ダイアログボッ
クスの［ディレクトリサービス］タブの［DIT ベース］ボックス
で、以下の入力を行います。
データベースプロファイル
OU=miami.OU=sales.O=sybase
•
アプリケーション
DS_DitBase をコードに指定するには、以下の入
力を行います。
SQLCA.DBParm ="DS_DitBase =
'OU=miami.OU=sales.O=sybase'"
関連項目
接続リファレンス
DS_Alias
DS_Copy
DS_Failover
DS_Password
DS_Principal
DS_Provider
DS_TimeLimit
Release
67
DS_Failover
DS_Failover
機能
DS_Failover は、 PowerBuilder から Open Client を経由して Sybase
Adaptive Server Enterprise データベースにアクセスするときに、アプリ
ケーションでネットワークベースのディレクトリサービスを有効に
するために設定できるパラメータのうちの 1 つです。ほかのディレク
トリサービスパラメータについては、「関連項目」を参照してくださ
い。
Sybase Open Client Client-Library （CT-Lib）は、ディレクトリに対して、
論理サーバ名をネットワークアドレスへマッピングすることを要求
します。このディレクトリのソースは、 Sybase Interfaces ファイル、ま
たはネットワークベースのディレクトリサービスプロバイダ（DCE
Cell Directory Services または Windows NT レジストリなど）のいずれか
にすることができます。
アプリケーションが Interfaces ファイル以外のディレクトリソースを
使用するようにしたい場合は、 CT-Lib が適切なディレクトリドライバ
をロードできる必要があります。 DS_Failover を設定して、 CT-Lib が要
求されたドライバをロードできない場合に、自動的にディレクトリ
ソースとして Interfaces ファイルを使用する（フェイルオーバ）かど
うかを指定できます。
デフォルトでは、 DS_Failover は、要求されたディレクトリドライバを
ロードできない場合、 CT-Lib がディレクトリソースとして Interfaces
ファイルを使用するように指定します。
DS_Failover の値は、 PowerBuilder からデータベースに接続する前に指
定します。
サードパーティのディレクトリサービスプロバイダの使用
Sybase が Open Client ディレクトリサービスでテストを行ったサード
パーティのディレクトリサービスプロバイダおよびオペレーティン
グシステムプラットフォームの詳細については、Open Client のドキュ
メントを参照してください。
対象
SYC Sybase Adaptive Server Enterprise
構文
DS_Failover = value
68
PowerBuilder
第1章
パラメータ
value
データベースパラメータの解説
説明
CT-Lib が要求されたドライバをロードできない場合に、デ
フォルトで Interfaces ファイルをディレクトリソースとし
て使う（フェイルオーバ）かどうかを指定する値。以下
のいずれかの値を指定します。
• 0 CT-Lib は、要求されたディレクトリドライバをロー
ドできない場合に、ディレクトリソースとして
Interfaces ファイルを使用できません。また、 'No' また
は 'False' をこの値に指定することもできます。
• 1 （デフォルト） CT-Lib は、要求されたディレクトリ
ドライバをロードできない場合に、ディレクトリソー
スとして Interfaces ファイルを使用できます。また、
'Yes' または 'True' をこの値に指定することもでき
ます。
デフォルト値
DS_Failover = 1
解説
設定が必要な場合要求されたディレクトリドライバをロードでき
ない場合に、CT-Lib がディレクトリソースとして Interfaces ファイルを
使用できないようにするには、 DS_Failover を 0 に設定します。
DS_Failover を 0 に設定して Interfaces ファイルを使用できないように
している場合で、かつ CT-Lib が要求されたディレクトリドライバを
ロードできない場合、接続のディレクトリソースは定義されません。
このため、ディレクトリアクセスを要求する一部の処理は失敗しま
す。
Release パラメータの設定このパラメータを有効にするには、Release
パラメータに 11 以上を設定して、アプリケーションが適切なバージョ
ンの Sybase Open Client Client-Library （CT-Lib）の動作を使用すること
を指定する必要があります。詳細については、 Release パラメータの説
明を参照してください。
使用のための要件 DS_Failover または、Open Client ディレクトリサー
ビスをサポートしているほかのパラメータを使用するには、
PowerBuilder アプリケーションでディレクトリサービスを使用するた
めの一定の要件を満たしている必要があります。詳細については、
『データベースとの接続』マニュアルの「Open Client のディレクトリ
サービスを使用するための条件」を参照してください。
対応する CT-Lib 接続プロパティ DS_Failover に値を指定すると、
CS_DS_FAILOVER という名前の、対応する Sybase CT-Lib 接続プロパ
ティが設定されます。
接続リファレンス
69
DS_Password
例
要求されたディレクトリドライバをロードできない場合に、CT-Lib が
ディレクトリソースとして Interfaces ファイルを使用できないように
するには、以下のようにします。
•
DB プロファイル設定ダイアログボッ
クスの［ディレクトリサービス］タブの［フェイルオーバーを有
効にする］チェックボックスをオフにします。
•
アプリケーション
データベースプロファイル
コードに次のように入力します。
SQLCA.DBParm = "DS_Failover = 0"
関連項目
DS_Alias
DS_Copy
DS_DitBase
DS_Password
DS_Principal
DS_Provider
DS_TimeLimit
Release
DS_Password
機能
DS_Password は、 PowerBuilder から Open Client 12.5 以降のソフトウェ
アを経由して Sybase Adaptive Server Enterprise データベースにアクセス
するときに、アプリケーションでネットワークベースのディレクトリ
サービスを有効にするために設定できるパラメータのうちの 1 つで
す。ほかのディレクトリサービスパラメータについては、「関連項目」
を参照してください。
一部のディレクトリサービスプロバイダおよびドライバでは、認証さ
れているプリンシパル（ユーザ ID）名とパスワードで、アプリケー
ションによるディレクトリエントリへのアクセスを制御することが
求められます。そのようなプロバイダおよびドライバの場合に、
DS_Principal と DS_Password は、ディレクトリサービスプロバイダに
ユーザを識別させるためにアプリケーションが使用するプリンシパル
名とパスワードを指定します。
DS_Password の値は、PowerBuilder からデータベースに接続する前に指
定します。
対象
SYC Sybase Adaptive Server Enterprise
構文
DS_Password = 'password'
70
PowerBuilder
第1章
パラメータ
password
デフォルト値
データベースパラメータの解説
説明
DS_Principal パラメータで指定したプリンシパル名（ユー
ザ ID）と関係付けられているパスワード
なし
値を指定しない場合、 DS_Password または対応する Sybase Open Client
Client-Library （CT-Lib）接続パラメータの CS_DS_PASSWORD は設定
されません。
解説
設定が必要な場合ディレクトリサービスプロバイダがディレクト
リアクセスに対して認証されたプリンシパル名を要求する場合は、
DS_Password を、ディレクトリサービスのプリンシパル名と一緒に使
うパスワードに設定します。
Release パラメータの設定このパラメータを有効にするには、Release
パラメータに 11 以上を設定して、アプリケーションが適切なバージョ
ンの Sybase Open Client Client-Library （CT-Lib）の動作を使用すること
を指定する必要があります。詳細については、 Release パラメータの説
明を参照してください。
使用のための要件 DS_Password、または Open Client 12.5 ディレクト
リサービスをサポートしているほかのパラメータを使用するには、
PowerBuilder アプリケーションでディレクトリサービスを使用するた
めの一定の要件を満たしている必要があります。詳細については、
『データベースとの接続』マニュアルの「Open Client のディレクトリ
サービスを使用するための条件」を参照してください。
対応する CT-Lib 接続プロパティ DS_Password に値を指定すると、
CS_DS_Password という名前の、対応する Sybase CT-Lib 接続プロパ
ティが設定されます。
例
アプリケーションのパスワードとして MYPASS を指定するには、以下
のようにします。
•
DB プロファイル設定ダイアログボッ
クスの［ディレクトリサービス］タブの［パスワード］ボックス
で、以下の入力を行います。
データベースプロファイル
MYPASS
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "DS_Password='MYPASS'"
関連項目
接続リファレンス
DS_Alias
DS_Copy
DS_DitBase
71
DS_Principal
DS_Failover
DS_Principal
DS_Provider
DS_TimeLimit
Release
DS_Principal
機能
DS_Principal は、 PowerBuilder から Open Client を経由して Sybase
Adaptive Server Enterprise データベースにアクセスするときに、アプリ
ケーションでネットワークベースのディレクトリサービスを有効に
するために設定できるパラメータのうちの 1 つです。ほかのディレク
トリサービスパラメータについては、「関連項目」を参照してくださ
い。
一部のディレクトリサービスプロバイダおよびドライバでは、認証さ
れているプリンシパル（ユーザ ID）名で、アプリケーションによる
ディレクトリエントリへのアクセスを制御することが求められます。
そのようなプロバイダおよびドライバの場合に、 DS_Principal と
DS_Password は、ディレクトリサービスプロバイダにユーザを識別さ
せるためにアプリケーションが使用するプリンシパル名とパスワード
を指定します。
DS_Principal パラメータは、PowerBuilder からデータベースに接続する
前に指定します。
サードパーティのディレクトリサービスプロバイダの使用
Sybase が Open Client ディレクトリサービスでテストを行ったサード
パーティのディレクトリサービスプロバイダおよびオペレーティン
グシステムプラットフォームの詳細については、Open Client のドキュ
メントを参照してください。
対象
SYC Sybase Adaptive Server Enterprise
構文
DS_Principal = 'principal_name'
パラメータ
principal_name
デフォルト値
72
説明
ディレクトリサービスプロバイダにユーザを識別させる
ためにアプリケーションが使用するプリンシパル名
なし
PowerBuilder
第1章
データベースパラメータの解説
値を指定しない場合、 DS_Principal または対応する Sybase Open Client
Client-Library （CT-Lib）接続パラメータの CS_DS_PRINCIPAL は設定
されません。
解説
設定が必要な場合ディレクトリサービスプロバイダがディレクト
リアクセスに対して認証されたプリンシパル名を要求する場合は、
DS_Principal を、ディレクトリサービスのパスワードと一緒に使うプ
リンシパル（ユーザ ID）名に設定します。
Release パラメータの設定このパラメータを有効にするには、Release
パラメータに 11 以上を設定して、アプリケーションが適切なバージョ
ンの Sybase Open Client Client-Library （CT-Lib）の動作を使用すること
を指定する必要があります。詳細については、 Release パラメータの説
明を参照してください。
使用のための要件 DS_Principal、または Open Client ディレクトリ
サービスをサポートしているほかのパラメータを使用するには、
PowerBuilder アプリケーションでディレクトリサービスを使用するた
めの一定の要件を満たしている必要があります。詳細については、
『データベースとの接続』マニュアルの「Open Client のディレクトリ
サービスを使用するための条件」を参照してください。
対応する CT-Lib 接続プロパティ DS_Principal に値を指定すると、
CS_DS_PRINCIPAL という名前の、対応する Sybase CT-Lib 接続プロパ
ティが設定されます。
例
アプリケーションのプリンシパル名として JSMITH を指定するには、
以下のようにします。
•
DB プロファイル設定ダイアログボッ
クスの［ディレクトリサービス］タブの［プリンシパル名］ボッ
クスで、以下の入力を行います。
データベースプロファイル
JSMITH
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "DS_Principal = 'JSMITH'"
関連項目
接続リファレンス
DS_Alias
DS_Copy
DS_DitBase
DS_Failover
DS_Password
DS_Provider
DS_TimeLimit
Release
73
DS_Provider
DS_Provider
機能
DS_Provider は、 PowerBuilder から Open Client を経由して Sybase
Adaptive Server Enterprise データベースにアクセスするときに、アプリ
ケーションでネットワークベースのディレクトリサービスを有効に
するために設定できるパラメータのうちの 1 つです。ほかのディレク
トリサービスパラメータについては、「関連項目」を参照してくださ
い。
Open Client ディレクトリサービスを使用するときには、各ディレクト
リサービスプロバイダで要求されるドライバがロードできるように、
Open Client/Open Server Configuration ユーティリティで、使用している
プロバイダ名を指定する必要があります。デフォルトのディレクトリ
サービスプロバイダは、Open Client/Open Server Configuration ユーティ
リティで現在アクティブに指定されているプロバイダです。
DS_Provider を使うと、デフォルトの（アクティブな）プロバイダで
はない、Open Client/Open Server Configuration ユーティリティでリス
トされているディレクトリサービスプロバイダ名を指定できます。
DS_Provider のデフォルト値は、 Open Client/Open Server Configuration
ユーティリティで現在アクティブに指定されているプロバイダ名で
す。
DS_Provider パラメータは、 PowerBuilder からデータベースに接続する
前に指定します。
サードパーティのディレクトリサービスプロバイダの使用
Sybase が Open Client ディレクトリサービスでテストを行ったサード
パーティのディレクトリサービスプロバイダおよびオペレーティン
グシステムプラットフォームの詳細については、Open Client のドキュ
メントを参照してください。
対象
SYC Sybase Adaptive Server Enterprise
構文
DS_Provider = 'provider_name'
パラメータ
provider_name
説明
ディレクトリサービスに使用するディレクトリサービス
プロバイダ名
プロバイダ名では大文字と小文字が区別されます。 Open
Client/Open Server Configuration ユーティリティで表示さ
れるとおりに指定する必要があります。
デフォルト値
74
DS_Provider のデフォルト値は、 Open Client/Open Server Configuration
ユーティリティで現在アクティブに指定されたプロバイダ名です。
PowerBuilder
第1章
解説
データベースパラメータの解説
設定が必要な場合 DS_Provider は、デフォルトの（アクティブな）プ
ロバイダではなく、 Open Client/Open Server Configuration ユーティリ
ティで指定されるディレクトリサービスプロバイダを使用する場合
に設定します。 Open Client/Open Server Configuration ユーティリティの
使い方については、 Sybase Open Client/Server の『設定ガイド』マニュ
アルを参照してください。
Release パラメータの設定このパラメータを有効にするには、Release
パラメータに 11 以上を設定して、アプリケーションが適切なバージョ
ンの Sybase Open Client Client-Library （CT-Lib）の動作を使用すること
を指定する必要があります。詳細については、 Release パラメータの説
明を参照してください。
使用のための要件 DS_Provider または、Open Client ディレクトリサー
ビスをサポートしているほかのパラメータを使用するには、
PowerBuilder アプリケーションでディレクトリサービスを使用するた
めの一定の要件を満たしている必要があります。詳細については、
『データベースとの接続』マニュアルの「Open Client のディレクトリ
サービスを使用するための条件」を参照してください。
対応する CT-Lib 接続プロパティ DS_Provider に値を指定すると、
CS_DS_PROVIDER という名前の、対応する Sybase CT-Lib 接続プロパ
ティが設定されます。
例
ディレクトリサービスプロバイダ名として NTREGISTRY を指定する
には、以下のようにします。
•
DB プロファイル設定ダイアログボッ
クスの［ディレクトリサービス］タブの［プロバイダ］ボックス
で、以下の入力を行います。
データベースプロファイル
NTREGISTRY
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "DS_Provider='NTREGISTRY'"
関連項目
接続リファレンス
DS_Alias
DS_Copy
DS_DitBase
DS_Failover
DS_Password
DS_Principal
DS_TimeLimit
Release
75
DS_TimeLimit
DS_TimeLimit
機能
DS_TimeLimit は、 PowerBuilder から Open Client を経由して Sybase
Adaptive Server Enterprise データベースにアクセスするときに、アプリ
ケーションでネットワークベースのディレクトリサービスを有効に
するために設定できるパラメータのうちの 1 つです。ほかのディレク
トリサービスパラメータについては、「関連項目」を参照してくださ
い。
一部のディレクトリサービスプロバイダおよびドライバは、ディレク
トリ検索に対する時間制限の使用をサポートしています。そのような
ディレクトリサービスプロバイダおよびドライバの場合、DS_TimeLimit
は、ディレクトリ検索を続行できる秒数を指定します。
デフォルトでは、 DS_TimeLimit は、ディレクトリ検索に対して時間制
限が設けられないようにします。
DS_TimeLimit パラメータは、 PowerBuilder からデータベースに接続す
る前に指定します。
サードパーティのディレクトリサービスプロバイダの使用
Sybase が Open Client ディレクトリサービスでテストを行ったサード
パーティのディレクトリサービスプロバイダおよびオペレーティン
グシステムプラットフォームの詳細については、Open Client のドキュ
メントを参照してください。
対象
SYC Sybase Adaptive Server Enterprise
構文
DS_TimeLimit='value'
パラメータ
value
説明
ディレクトリ検索を続行できる秒数を指定する値。また、
'no_limit' （デフォルト）を指定すると、ディレクトリ検
索に時間制限が設定されないようにすることもできます。
指定した時間が経過した場合、および検索対象が見つから
なかった場合は、ディレクトリ検索は成功せず、
PowerBuilder の接続は解除されます。
デフォルト値
DS_TimeLimit = 'no_limit'
解説
Release パラメータの設定 DS_TimeLimit を有効にするには、 Release
パラメータに 11 以上を設定して、アプリケーションが適切なバージョ
ンの Sybase Open Client Client-Library （CT-Lib）の動作を使用すること
を指定する必要があります。詳細については、 Release パラメータの説
明を参照してください。
76
PowerBuilder
第1章
データベースパラメータの解説
使用のための要件 DS_TimeLimit または、 Open Client ディレクトリ
サービスをサポートしているほかのパラメータを使用するには、
PowerBuilder アプリケーションでディレクトリサービスを使用するた
めの一定の要件を満たしている必要があります。詳細については、
『データベースとの接続』マニュアルの「Open Client のディレクトリ
サービスを使用するための条件」を参照してください。
対応する CT-Lib 接続プロパティ DS_TimeLimit に値を指定すると、
CS_DS_TIMELIMIT という名前の、対応する Sybase CT-Lib 接続プロパ
ティが設定されます。
例
ディレクトリ検索を最長で 120 秒（2 分）間続行できるように指定す
るには、以下のようにします。
DB プロファイル設定ダイアログボッ
クスの［ディレクトリサービス］タブの［ディレクトリ検索時間
の最大値］ボックスに 120 と入力します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="DS_TimeLimit = 120"
関連項目
DS_Alias
DS_Copy
DS_DitBase
DS_Failover
DS_Password
DS_Principal
DS_Provider
Release
EncryptPassword
機能
OLE DB データプロバイダに接続するときに、 PowerBuilder が自動的
にパスワードを暗号化するかどうかを指定します。
EncryptPassword を指定するタイミング
EncryptPassword パラメータは、データベースに接続する前に指定しま
す。
対象
OLE DB
構文
EncryptPassword = 'value'
接続リファレンス
77
FoDelay
パラメータ
value
説明
PowerBuilder がパスワードを暗号化するかどうかを指定する
値。以下のいずれかの値を指定します。
• True PowerBuilder がパスワードを暗号化します。
• False （デフォルト） PowerBuilder はパスワードを暗号化し
ません。
デフォルト値
EncryptPassword = 'False'
例
OLE DB データプロバイダに接続するときに、PowerBuilder にパスワー
ドを暗号化させるには、以下の操作を行います。
DB プロファイル設定ダイアログボッ
クスの［セキュリティ］タブの［パスワードの暗号化］チェック
ボックスをオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="EncryptPassword='True'"
関連項目
DataLink
IntegratedSecurity
MaskPassword
PersistEncrypted
FoDelay
機能
現行のデータベースサーバがダウンした場合に PowerBuilder が別の
データベースサーバへのフェイルオーバを試みるまで待機する時間
（ミリ秒単位）を指定します。
FoDelay を指定するタイミング
FoDelay パラメータは、データベースに接続する前に指定します。
対象
O84 Oracle8i （8.1.5 以降のデータベース接続のみ）
O90 Oracle9i
O10 Oracle 10g
構文
FoDelay='value'
パラメータ
value
78
説明
PowerBuilder が別のデータベースサーバへのフェイルオーバ
を試みるまで待機する時間（ミリ秒単位）を指定します。
PowerBuilder
第1章
データベースパラメータの解説
デフォルト値
FoDelay = '10'
解説
フェイルオーバの遅延の値は、フェイルオーバを有効にしている場合
にのみ入力可能です。
このパラメータは、動的に設定することができません。接続の確立時
に設定された値は、接続が切断するまで有効です。
例
PowerBuilder がフェイルオーバを試みるまで 20 ミリ秒待機するよう指
定するには、以下の操作を行います。
•
DB プロファイル設定ダイアログボッ
クスの［ネットワーク］タブの［リトライ間隔］ボックスに 20 と
入力します。
•
アプリケーション
データベースプロファイル
コードに次のように入力します。
SQLCA.DBParm="FoDelay='20'"
関連項目
SvrFailover
FoDialog
機能
フェイルオーバの実行条件を指示する実行時ダイアログボックスを
表示するかどうかを指定します。
FoDialog を指定するタイミング
FoDialog パラメータは、データベースに接続する前に指定します。
対象
O84 Oracle8i （8.1.5 以降のデータベース接続のみ）
O90 Oracle9i
O10 Oracle 10g
SYC
構文
FoDialog='value'
パラメータ
value
デフォルト値
接続リファレンス
説明
フェイルオーバの実行条件を指示する実行時ダイアログ
ボックスを表示するかどうかを指定します。以下のいずれか
の値を指定します。
• No （デフォルト）ダイアログボックスを表示しないよう
に指定します。
• Yes ダイアログボックスを表示するように指定します。
FoDialog = 'No'
79
FoRetryCount
解説
実行時ダイアログボックスは、フェイルオーバを有効にしている場合
にのみ表示可能です。このダイアログボックスは、 EAServer または
COM+ では表示されません。
このパラメータは、動的に設定することができません。接続の確立時
に設定された値は、接続が切断するまで有効です。
例
フェイルオーバの際に実行時ダイアログボックスが表示されるよう
に指定するには、以下の操作を行います。
DB プロファイル設定ダイアログボッ
クスの［ネットワーク］タブで、［フェイルオーバ時にダイアログ
を表示］チェックボックスをオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "FoDialog = 'Yes'"
関連項目
SvrFailover
FoRetryCount
機能
現行のデータベースサーバがダウンした場合に PowerBuilder が別の
データベースサーバへのフェイルオーバを試みる回数を指定します。
FoRetryCount を指定するタイミング
FoRetryCount パラメータは、データベースに接続する前に指定します。
対象
O84 Oracle8i （8.1.5 以降のデータベース接続のみ）
O90 Oracle9i
O10 Oracle 10g
構文
FoRetryCount='value'
パラメータ
value
説明
フェイルオーバの試行回数を指定します。
デフォルト値
FoRetryCount = '10'
解説
フェイルオーバの試行回数は、フェイルオーバを有効にしている場合
にのみ入力可能です。
このパラメータは、動的に設定することができません。接続の確立時
に設定された値は、接続が切断するまで有効です。
80
PowerBuilder
第1章
例
データベースパラメータの解説
PowerBuilder にフェイルオーバを 20 回試行させるには、以下の操作を
行います。
DB プロファイル設定ダイアログボッ
クスの［ネットワーク］タブで、［リトライ回数］ボックスに 20
を入力します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="FoRetryCount='20'"
関連項目
SvrFailover
FormatArgsAsExp
機能
データウィンドウオブジェクトの Decimal データ型の検索引数が 13～
15 桁のときに、 PowerBuilder がその引数を指数表記に変換するかどう
かを制御します。 FormatArgsAsExp が Yes （デフォルト）に設定されて
いる場合、 PowerBuilder はこの変換を実行します。
FormatArgsAsExp を指定するタイミング
FormatArgsAsExp の値は、データベースに接続する前に指定します。
対象
JDB JDBC
ODBC インタフェース
O84 Oracle8i
O90 Oracle9i
O10 Oracle 10g
SYC および SYJ Sybase Adaptive Server Enterprise
構文
FormatArgsAsExp= 'value'
パラメータ
value
デフォルト値
接続リファレンス
説明
データウィンドウまたはレポートの Decimal データ型の
検索引数が 13 ～ 15 桁のときに、 PowerBuilder がその引数
を指数表記に変換するかどうかを指定します。以下のいず
れかの値を指定します。
• Yes 検索引数が 13 ～ 15 桁の場合、 Decimal データ型
を指数表記に変換します。
• No
（デフォルト）検索引数が 13 ～ 15 桁の場合でも
Decimal 型のままにし、指数表記へのデフォルト変換を
実行しません。
FormatArgsAsExp = 'No'
81
GetConnectionOption
解説
設定が必要な場合 FormatArgsAsExp の設定値は、特に大規模なデー
タベースにアクセスする場合に、データウィンドウオブジェクトでの
データ検索の処理速度に影響を与えることがあります。
FormatArgsAsExp が Yes に設定されている場合、 PowerBuilder は 13 ～
15 桁の Decimal 型の検索引数を指数表記に変換します。一部の DBMS
オプティマイザは、結果の指数表記を別のデータ型として解釈し、テー
ブル内のすべての行をスキャンしてそのデータ型を見つけようとしま
す。この処理の際には、たとえば、大きなテーブルが多数ある DB2
データベースにアクセスしている場合、データ検索の速度が遅くなる
可能性があります。
FormatArgsAsExp を No に設定すると、 PowerBuilder は検索引数を
Decimal のままにし、指数表記への変換を行いません。このため、大規
模なデータベースでのデータ検索を速く処理できます。
検索引数のサイズの制限
Decimal 型の検索引数が 16 桁未満の場合に限り、 FormatArgsAsExp パ
ラメータを使用します。
例
13 ～ 15 桁の検索引数が指数表記に変換されるように指定するには、以
下の操作を行います。
DB プロファイル設定ダイアログボッ
クスの［構文］タブで、［指数表記で表示］チェックボックスをオ
ンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="FormatArgsAsExp='Yes'"
GetConnectionOption
機能
キャッシュ内のすべての接続が使用されている場合の EAServer の動
作を指定します。このパラメータは、 PowerBuilder カスタムクラス
ユーザオブジェクトが EAServer コンポーネントとして配布される場
合だけ使用します。
対象
JDB JDBC
ODBC
O84 Oracle8i
O90 Oracle9i
SYJ Sybase Adaptive Server Enterprise
82
PowerBuilder
第1章
構文
データベースパラメータの解説
GetConnectionOption = 'value'
パラメータ
value
説明
キャッシュ内のすべての接続が使用されている場合の
EAServer の動作を指定する値。以下のいずれかの値を指定
します。
• JAG_CM_FORCE （デフォルト）新しい接続を割り当て
て開きます。新しい接続はキャッシュされず、接続が
明示的または暗黙的にコンポーネントによって閉じら
れるときに割り当てが解除されます。
• JAG_CM_NOWAIT 接続を確立できない場合はエラー
を生成して失敗します。
• JAG_CM_WAIT 接続が利用可能になるまで結果を返し
ません。
デフォルト値
GetConnectionOption = 'JAG_CM_FORCE'
解説
このパラメータは、動的に設定することができません。接続の確立時
に設定された値は、接続が切断するまで有効です。
SYJ インタフェースの使用
Sybase EAServer では、わずかに異なるバージョンの CT-Lib ソフトウェ
アが使用されます。したがって、実行時に、 Adaptive Server Enterprise
データベースに接続するには SYC ではなく SYJ データベースインタ
フェースを使用する必要があります。 SYJ の DB プロファイル設定ダ
イアログボックスを使用すると、適切な接続パラメータが設定され、
構文を［プレビュー］タブからトランザクションオブジェクトのスク
リプトにコピーできます。
ただし、 PowerBuilder 開発環境からデータベースに接続する場合には
SYJ インタフェースを使用できません。したがって、開発段階では（コ
ンポーネントが EAServer に配布される前）、 SYC を使用してデータ
ベースに接続する必要があります。
PowerBuilder を使用して EAServer コンポーネントを作成する方法につ
いては、『アプリケーションテクニック』マニュアルを参照してくだ
さい。
例
DB プロファイル設定ダイアログボックスの［EAServer］タブで、［接
続取得オプション］ドロップダウンリストの「JAG_CM_NOWAIT」を
選択します。 GetConnectionOption パラメータの PowerScript 構文が、次
のように［プレビュー］タブに表示されます。
SQLCA.DBParm = "GetConnectionOption = 'JAG_CM_NOWAIT'"
接続リファレンス
83
Host
この構文を［プレビュー］タブからスクリプトにコピーします。
関連項目
CacheName
ReleaseConnectionOption
UseContextObject
Host
機能
PowerBuilder からデータベースに接続するときに、接続するワークス
テーション名を指定します。ただし、 DBMS がこれをサポートしてい
る場合に限ります。 Host パラメータには、データベースへの接続時に
作成されるプロセスを識別するための、 10 文字以内のラベルを設定で
きます。このラベルによって、データベースサーバ上で稼働している
ほかのプロセスと、自分のプロセスを区別できます。
Host を指定するタイミング
Host パラメータは、 PowerBuilder からデータベースに接続する前に指
定します。
対象
SYC Sybase Adaptive Server Enterprise
構文
Host = 'workstation_name'
デフォルト値
なし
解説
Host
パラメータの値を指定すると、 PowerBuilder
によって、
CS_HOSTNAME 接続プロパティに、指定したワークステーション名が
設定されます。
指定した Host パラメータの値は、 SQL Server データベースの中の
MASTER.DBO.SYSPROCESSES テーブルの、Hostname カラムに表示さ
れます。 Host パラメータの使い方は、 PowerBuilder のアプリケーショ
ンの設計方法によって異なります。
たとえば、サイトで使用するテーブルのセキュリティを守るため、特
定のアプリケーションからのアクセスに限って更新されるものとしま
す。このためには、エンドユーザではなく、PowerBuilder のアプリケー
ションに対して明示的な権限を与えます。アプリケーションは、エン
ドユーザに対して認証用の ID やパスワードの入力を求め、これを確
認してから、特別なアプリケーションログイン ID を介してデータベー
スに接続します。このアプリケーションログイン ID だけが、テーブル
を更新する権限を持ちます。
84
PowerBuilder
第1章
データベースパラメータの解説
この例の場合、 Host パラメータを使用して、アプリケーションを稼働
しているエンドユーザの名前を格納できます。
例
例1
•
ホスト名を Alan に設定するには、以下の操作を行います。
DB プロファイル設定ダイアログボッ
クスの［ネットワーク］タブで、［ワークステーション名］ボック
スに次のように入力します。
データベースプロファイル
Alan
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "Host='Alan'"
AppName パラメータと Host パラメータを一緒に指定することに
よって、アプリケーション名とホスト名の両方を指定できます。ホス
ト名を Jane に、アプリケーション名を Sales に設定するには、以下の
操作を行います。
例2
DB プロファイル設定ダイアログボッ
クスの［ネットワーク］タブで、［ワークステーション名］ボック
スに Jane、［アプリケーション名］ボックスに Sales と入力します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "Host='Jane',AppName='Sales'"
例 3 前の例では、 Host 名はハードコードされています。ホスト名は、
Windows の GetComputerNameA 関数を使用して動的に取得できます。
PowerScript にはこれと同様の関数はありません。外部関数の宣言は次
のように行います。
FUNCTION boolean GetComputerNameA(ref string cname,ref
long nbuf) LIBRARY "Kernel32.dll"
アプリケーションの Open イベント内の以下のコードでは、外部関数
呼び出しを使用してホスト名を取得し、その値を Host パラメータに設
定します。取得するホスト名のために十分な容量が割り当てられてい
る必要があります。
string ls_compname
long ll_buf
ll_buf = 25
ls_compname = space(ll_buf)
GetComputerNameA(ls_compname, ll_buf)
// Profile mysyb
SQLCA.DBMS = "SYC Adaptive Server Enterprise"
SQLCA.Database = "mydata"
接続リファレンス
85
IdentifierQuoteChar
SQLCA.LogPass = "mylogpass"
SQLCA.ServerName = "mysybsvr"
SQLCA.LogId = "mylogid"
SQLCA.AutoCommit = False
SQLCA.DBParm = "Host='" + ls_compname + "'"
Connect using SQLCA;
関連項目
AppName
IdentifierQuoteChar
機能
SQL 文を作成するときに、識別子（テーブル、カラム、インデックス、
制約）の名前の区切り記号として使用する、単引用符文字を指定しま
す。 PowerBuilder は、ドライバまたはデータプロバイダから返される
デフォルトの引用符文字ではなく、指定された引用符文字を使用しま
す。
DelimitIdentifier を Yes に設定する
IdentifierQuoteChar パラメータを有効にするためには、DelimitIdentifier パ
ラメータを Yes に設定します。この設定がないと、 PowerBuilder はデ
フォルトで、 SQL
文の中の識別子を区切りません。また、
IdentifierQuoteChar パラメータに指定した値を無視します。
対象
ADO.NET
JDB JDBC
ODBC（ドライバおよびバックエンド DBMS がサポートしている場合）
OLE DB
構文
IdentifierQuoteChar = 'quote_character'
パラメータ
quote_character
デフォルト値
説明
SQL 文の中で識別子の名前を区切るために使用する 1 つ
の文字。この文字が、ドライバまたはデータプロバイダ
のデフォルトの引用符文字に代わって使用されます。
なし
PowerBuilder は、以下の順序で検索を実行し、 IdentifierQuoteChar 値を
決定します。
86
PowerBuilder
第1章
データベースパラメータの解説
1
使用しているデータベースプロファイルに対応する PowerBuilder
初期設定ファイルの中のセクション（開発環境の場合）、またはト
ランザクションオブジェクトパラメータのプロパティの値
（PowerBuilder アプリケーションの場合）
2
使用している ODBC ドライバに対応する、 PBODB100 初期設定
ファイルの中のセクション、または使用している JDBC ドライバ
に対応する、レジストリの中のセクション
これらの場所で IdentifierQuoteChar 値が見つからない場合、ドライバに対して
SQLGetInfo が呼び出され、デフォルトの SQL_IDENTIFIER_QUOTE_CHAR
値が返されます。
OLE DB インタフェースを使用する場合
IdentifierQuoteChar パラメータに値が指定されていない場合、引用符文
字は使用されません。
解説
一部のドライバはデフォルトで、バッククォート（`）などの文字を、
引用符文字として返します。これを PowerBuilder では判別できません。
この結果、 PowerBuilder において、これらのドライバの区切り記号が
無効になります。
しかし、区切り記号を必要とする識別子がある SQL 文を使用して、そ
の区切り記号が無効となっているドライバを使用した場合に、構文エ
ラーが発生する恐れがあります。このようなエラーを防ぐためには、
IdentifierQuoteChar パラメータを設定して、ドライバのデフォルトの引
用符文字を使用しないようにします。
例
SQL 文の中で識別子を区切る引用符文字として c が使用されるように
指定するには、以下の操作を行います。
DB プロファイル設定ダイアログボッ
クスの［構文］タブで、［識別子の引用記号］ボックスに c と入力
します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="IdentifierQuoteChar='c'"
関連項目
接続リファレンス
DelimitIdentifier
87
ImpersonationLevel
ImpersonationLevel
機能
データサーバが OLE DB データプロバイダおよび PowerBuilder のイ
ンパーソネーション（偽装）を行うときに使用できるインパーソネー
ションレベルを指定します。このパラメータは、 Remote Procedure Call
（RPC）接続以外のネットワーク接続だけに適用されます。
ImpersonationLevel を指定するタイミング
ImpersonationLevel パラメータは、データベースに接続する前に指定し
ます。
対象
OLE DB
構文
ImpersonationLevel = 'value'
パラメータ
value
説明
インパーソネーションレベルを指定する値。以下のいずれか
の値を指定します。
• Not set どのレベルのインパーソネーションも選択されま
せん。
• Anonymous クライアントはサーバに対して匿名であり、
サーバプロセスはクライアントについての識別情報を取得
できず、クライアントのインパーソネーションを行うこと
ができません。
• Delegate プロセスは、クライアントのセキュリティコン
テキストのインパーソネーションができ、クライアントの
かわりに動作できます。また、サーバプロセスはクライア
ントに代わってほかのサーバへの呼び出しが行えます。
• Identify サーバはクライアントの ID を取得できます。サー
バは ACL チェック用のクライアントをインパーソネー
ションできますが、システムオブジェクトにクライアント
としてアクセスすることはできません。
• Impersonate サーバプロセスは、クライアントのセキュリ
ティコンテキストのインパーソネーションができ、クライ
アントのかわりに動作できます。この情報は、呼び出しご
とではなく、接続が確立されたときに取得されます。
デフォルト値
ImpersonationLevel = 'Not set'
例
インパーソネーションレベルを anonymous に設定するには、以下の操
作を行います。
•
88
DB プロファイル設定ダイアログボッ
クスの［セキュリティ］タブで、［インパーソネーションレベル］
ドロップダウンリストの「Anonymous」を選択します。
データベースプロファイル
PowerBuilder
第1章
アプリケーション
•
データベースパラメータの解説
コードに次のように入力します。
SQLCA.DBParm =
"IMPERSONATIONLEVEL='DB_IMP_LEVEL_ANONYMOUS'"
関連項目
DataLink
INET_DBPATH
機能
Informix DBPATH の設定を指定します。 DBPATH 環境変数は、 Informix
データベースを格納しているディレクトリ名のリストを識別します。
INET_DBPATH パラメータは一般に、 Informix データベースがデータ
ベースサーバ上のディレクトリ以外にあるときに、その位置を指定す
るために使用します。
対象
IN9 Informix
構文
INET_DBPATH = 'server_db_path'
パラメータ
server_db_path
説明
Informix データベースが格納されているディレクトリの
名前
デフォルト値
デフォルトでは、 Informix.INI コンフィグレーションファイルの中で、
DBPATH 環境変数に対して指定されている値が使用されます。
例
例 1 HOME/Informix というディレクトリに Informix データベースが
格納されるように指定するには、以下の操作を行います。
•
DB プロファイル設定ダイアログボッ
クスの［ネットワーク］タブで、［DB パス］ボックスに次のよう
に入力します。
データベースプロファイル
/home/Informix
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="INET_DBPATH='/home/Informix'"
INET_DBPATH、 INET_PROTOCOL、 INET_SERVICE の値は、一
緒に指定できます。 /Informix というディレクトリに Informix データ
ベースを格納し、 SE9 サービスと TCP/IP ネットワークプロトコルを
使用して接続するように指定するには、以下の操作を行います。
例2
•
接続リファレンス
DB プロファイル設定ダイアログボッ
クスの［ネットワーク］タブで、［DB パス］ボックスに /Informix、
［サービス名］ボックスに SE9、［プロトコルの種類］ボックスに
tcp-ip と入力します。
データベースプロファイル
89
INET_PROTOCOL
•
アプリケーション
コードに、次のステートメントを 1 行で入力し
ます。
SQLCA.DBParm="INET_DBPATH='/Informix',
INET_SERVICE = 'se9',INET_PROTOCOL = 'tcp-ip'"
関連項目
INET_PROTOCOL
INET_SERVICE
INET_PROTOCOL
機能
Informix クライアントソフトウェアがリモートの Informix バージョン
9.x データベースサーバとの通信に使用する、ネットワークプロトコ
ルを指定します。
対象
IN9 Informix
構文
INET_PROTOCOL = 'network_protocol '
パラメータ
network_protocol
説明
Informix クライアントソフトウェアが使用するネット
ワークプロトコルの名前を表す文字列
サイトで使用できる適切なネットワークプロトコル
については、 Informix システム管理者に問い合わせて
ください。
デフォルト値
デフォルトでは、 Informix.INI コンフィグレーションファイルの中で
指定されているネットワークプロトコルが使用されます。
例
例 1 Informix クライアントソフトウェアが Novell IPX/SPX ネット
ワークプロトコルを使用するように指定するには、以下の操作を行い
ます。
•
DB プロファイル設定ダイアログボッ
クスの［ネットワーク］タブで、［プロトコルの種類］ボックスに
ipx と入力します。
•
アプリケーション
データベースプロファイル
コードに次のように入力します。
SQLCA.DBParm="INET_PROTOCOL='ipx'"
例 2 INET_DBPATH、 INET_PROTOCOL、 INET_SERVICE の値は、一
緒に指定できます。 /Informix というディレクトリに Informix データ
ベースを格納し、 SE9 サービスと TCP/IP ネットワークプロトコルを
使用して接続するように指定するには、以下の操作を行います。
90
PowerBuilder
第1章
データベースパラメータの解説
•
DB プロファイル設定ダイアログボッ
クスの［ネットワーク］タブで、［DB パス］ボックスに /informix、
［サービス名］ボックスに SE9、［プロトコルの種類］ボックスに
tcp-ip と入力します。
•
アプリケーション
データベースプロファイル
コードに、次のステートメントを 1 行で入力し
ます。
SQLCA.DBParm="INET_DBPATH='/Informix',INET_SERVICE=
'se9',INET_PROTOCOL='tcp-ip'"
関連項目
INET_DBPATH
INET_SERVICE
INET_SERVICE
機能
リモートの Informix データベースサーバがクライアントアプリケー
ションからの受信要求を受け付けるために使用するサービスの名前を
指定します。
対象
IN9 Informix
構文
INET_SERVICE = 'service_name'
パラメータ
service_name
説明
リモートの Informix データベースサーバがクライアント
アプリケーションからの受信要求を受け付けるために使
用するサービスの名前を指定する文字列
サイトで使用できる適切なサービス名については、
Informix システム管理者に問い合わせてください。
デフォルト値
デフォルトでは、 Informix.INI コンフィグレーションファイルの中で
指定されているサービス名が使用されます。
例
例 1 Informix データベースサーバが sqlexec というサービス名を使用
するように指定するには、以下の操作を行います。
DB プロファイル設定ダイアログボッ
クスの［ネットワーク］タブの［サービス名］ボックスに sqlexec
と入力します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="INET_SERVICE='sqlexec'"
接続リファレンス
91
Init_Prompt
例 2 INET_DBPATH、 INET_PROTOCOL、 INET_SERVICE の値は、一
緒に指定できます。 /Informix というディレクトリに Informix データ
ベースを格納し、 SE9 サービスと TCP/IP ネットワークプロトコルを
使用して接続するように指定するには、以下の操作を行います。
•
DB プロファイル設定ダイアログボッ
クスの［ネットワーク］タブで、［DB パス］ボックスに /informix、
［サービス名］ボックスに SE9、［プロトコルの種類］ボックスに
tcp-ip と入力します。
•
アプリケーション
データベースプロファイル
コードに、次のステートメントを 1 行で入力し
ます。
SQLCA.DBParm="INET_DBPATH='/Informix',INET_SERVICE=
'se9',INET_PROTOCOL='tcp-ip'"
関連項目
INET_DBPATH
INET_PROTOCOL
Init_Prompt
機能
初期化時にプロンプトを表示するかどうかを指定します。
Init_Prompt を指定するタイミング
Init_Prompt パラメータは、データベースに接続する前に指定します。
対象
OLE DB
構文
Prompt = 'value'
パラメータ
value
説明
初期化時にプロンプトを表示するかどうかを指定する値。以下
のいずれかの値を指定します。
• Not set プロンプトは表示されません。
• Always 初期化情報のプロンプトが常に表示されます。
• If needed 追加情報が必要な場合だけプロンプトが表示さ
れます。
デフォルト値
Init_Prompt = 'Not set'
例
初期化時にプロンプトが常に表示されるようにするには、以下の操作
を行います。
92
PowerBuilder
第1章
データベースパラメータの解説
DB プロファイル設定ダイアログボッ
クスの［システム］タブで、［プロンプト］ドロップダウンリスト
の「Always」を選択します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="INIT_PROMPT='DBPROMPT_PROMPT'"
関連項目
DataLink
InsertBlock
機能
PowerBuilder のデータパイプラインが転送先データベースのテーブル
に一度に挿入する行の数を指定します。
データパイプラインの使い方については、『ユーザーズガイド』マニュ
アルを参照してください。
対象
ODBC （ドライバおよびバックエンド DBMS がサポートしている場合
で、データパイプラインだけが対象です）
構文
InsertBlock = insert_blocking_factor
パラメータ
insert_blocking_factor
説明
データパイプラインが、転送先データベースのテー
ブルに、一度に挿入する行数。最大値は 100 行です
（デフォルト値は 100 行です）。
データパイプラインにおける、 ODBC データソー
スへのブロック挿入を無効にするには、転送先デー
タベースのデータベースプロファイルの中で、
InsertBlock を 1 に設定するか、 DisableBind を 1 に設
定します。
デフォルト値
InsertBlock = 100
解説
InsertBlock を使用するための要件 InsertBlock パラメータを使用する
ためには、以下の要件をすべて満たす必要があります。
接続リファレンス
•
データパイプラインの中で、 ODBC ドライバを使用して転送先
データベースにアクセスしていること
•
転送先データベースでバインド変数がサポートされていること
（バインド変数については、 DisableBind を参照）
93
InsertBlock
•
転送先データベースのデータベースプロファイルの中で、DisableBind
パラメータが 1 （デフォルトは 0）に設定されていないこと。これ
によって、 PowerBuilder の中で、コンパイル済み SQL 文の入力パ
ラメータのデフォルトバインドが許可される
•
データパイプラインの中で、［最大エラー件数］が 1 に設定されて
いること
Adaptive Server Anywhere ODBC ドライバと、 PB DataDirect ODBC ドラ
イバの大半は、最初の 2 つの要件を満たしています。
使用している ODBC ドライバが、これらの要件を満たしているかどう
かについては、ドライバ付属のマニュアルを参照してください。
InsertBlock 値の決定 PowerBuilder は、以下の順序で検索をして、
InsertBlock 値を決定します。
1
使用しているデータベースプロファイルに対応する、PowerBuilder
初期設定ファイルの中のセクション
2
使用している ODBC ドライバに対応する、 PBODB100 初期設定
ファイルの中のセクション
これらの場所で InsertBlock 値が見つからない場合、挿入ブロックファ
クタとしてデフォルト値の 100 行が適用されます。
設定後の処理 InsertBlock 値が決定されるとデータパイプラインは、
指定された行数をひとまとめにして、転送先データベースが使用して
いる ODBC ドライバへの 1 回の呼び出しでこれを挿入します。
InsertBlock 値やデータパイプラインのコミットファクタに 100 行より
小さな値を指定した場合は、指定行数をひとまとまりとして、転送先
データベースに挿入します。これに対して、 100 行より大きな値を指
定した場合は、一度に 100 行までをひとまとまりとして、転送先デー
タベースに挿入します。
データパイプラインが実際に使用する挿入ブロックファクタは、転送
先データベースに挿入される各カラムのデータサイズに依存します。
これに加えてデータパイプラインは、 1 つのカラムに対応するバッ
ファ内のデータが、 64K を越えることはありません。
ブロック挿入の禁止データパイプラインの中で、ODBC データソー
スに対するブロック挿入を禁止するには、転送先データベースのデー
タベースプロファイルで、以下のいずれかの操作を実行します。
94
•
InsertBlock パラメータを 1 に設定します。
•
DisableBind パラメータを 1 に設定します（コンパイル済み SQL 文
への入力パラメータのデフォルトバインドを禁止します）。
PowerBuilder
第1章
データパイプラインの中で、［最大エラー件数］を 1 以外の値に設
定します。
•
例
データベースパラメータの解説
データパイプラインにおける挿入ブロックファクタを 50 行に設定す
るには、以下の操作を行います。
DB プロファイル設定ダイアログボッ
クスの［トランザクション］タブの［Insert ブロック化係数］ボッ
クスに 50 と入力します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="InsertBlock=50"
関連項目
DisableBind
IntegratedSecurity
機能
データサーバがユーザを識別するために使用する認証サービスの名
前を指定します。
このパラメータが指定されると、ほかの OLE DB 認証パラメータ
（CacheAuthentication、EncryptPassword、MaskPassword、PersistEncrypted、
および PersistSecurityInfo）は必要なく、指定されていても無視されま
す。
IntegratedSecurity を指定するタイミング
IntegratedSecurity パラメータは、データベースに接続する前に指定しま
す。
対象
OLE DB
構文
IntegratedSecurity = 'value'
パラメータ
value
説明
認証サービスの名前を指定する文字列。 NULL の場合は、デ
フォルトの認証サービスが使用されます。
デフォルト値
なし
例
Security Support Provider Interface（SSPI）for Windows NT などの認証サー
ビスを使用するには、以下の操作を行います。
•
接続リファレンス
DB プロファイル設定ダイアログボッ
クスの［セキュリティ］タブで、［統合セキュリティ］ボックスに
認証サービスの名前を入力します。
データベースプロファイル
95
Isolation
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="IntegratedSecurity='SSPI'"
Isolation
機能
データベースへの接続時に使用する分離レベルを設定します。
マルチユーザデータベースでは、異なるユーザによって開始されたト
ランザクションがオーバーラップすることがあります。複数のトラン
ザクションがデータベース内の共用データにアクセスすると、お互い
に上書きしたり、衝突することがあります。
データベースとの接続時に分離レベルを設定できます。これにより、
同時に実行されるトランザクションがお互いに干渉せず、データベー
スの整合性を保つことができます。分離レベルは、トランザクション
の実行時に .NET Framework データプロバイダで使用されます。
PowerBuilder では、 Isolation データベースパラメータを使用して各種
のデータベースロックオプションを設定できます。各値は、 .NET
Framework が定義する分離レベルによって異なります。
Isolation 値を指定するタイミング
Isolation 値は、データベースに接続する前に指定します。 Isolation 値
は、データベースとの接続が発生したときに限って有効となります。
接続後に Isolation 値に変更を加えても、現在の接続への影響はありま
せん。
対象
ADO.NET
構文
Isolation='value'
パラメータ
value
説明
分離レベルを指定する文字列。値は、 .NET Framework
IsolationLevel 列挙のメンバに対応します。
• TC – Chaos
• 指定しない – DBMS のデフォルトの分離レベル（デフォル
ト）
• RC – Read Committed
• RU – Read Uncommitted
• RR – Repeatable Read
• TS – Serializable Transactions
96
PowerBuilder
第1章
データベースパラメータの解説
デフォルト値
デフォルトの Lock 値は、データベースの設定によって異なります。詳
細については、使用している DBMS のマニュアルを参照してくださ
い。
例
例 1 Isolation 値を RC （Read Committed）に設定するには、以下の操
作を行います。
•
DB プロファイル設定ダイアログボックスの［トランザ
クション］タブで、［分離レベル］ドロップダウンリストの「Read
Committed」を選択します。
•
アプリケーション
開発環境
以下の入力を行います。
SQLCA.DBParm="Isolation='RC'"
コード内での例の使用
データベースプロファイルで分離レベルを指定すると、構文が DB プ
ロファイル設定ダイアログボックスの［プレビュー］タブに表示され
ます。その構文を［プレビュー］タブからコードにコピーできます。
JavaVM
機能
JDBC データベースインタフェースで使用する Java VM のバージョン
を指定します。
JavaVM を指定するタイミング
JavaVM パラメータは、データベースに接続する前に指定します。
対象
JDB JDBC
構文
JavaVM = 'value'
パラメータ
value
説明
Java VM の名前を指定します。以下のいずれかの値を指定しま
す。
• Sun JRE 1.2 (Sun1.2)
• Sun JRE 1.3 (Sun1.3)
• Sun JRE 1.4 (Sun1.4)
デフォルト値
JavaVM='Sun1.4'
解説
動作の一貫性を確保するためには、開発時に使用した Java VM と同じ
バージョンのものを実行時に使用する必要があります。
接続リファレンス
97
KeepAlive
例
JavaVM パラメータを Sun JRE 1.3 に設定するには、以下の操作を行い
ます。
DB プロファイル設定ダイアログボッ
クスの［オプション］タブで、［Java VM］ドロップダウンリスト
の「Sun JRE 1.3」を選択します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "JavaVM='Sun1.3'"
KeepAlive
機能
接続をアクティブな状態に維持するためにパケットをデータベースに
送信するかどうかを決定します。
KeepAlive を指定するタイミング
KeepAlive パラメータは、データベースに接続する前に指定します。
対象
SYC Sybase Adaptive Server Enterprise
構文
KeepAlive = value
パラメータ
value
説明
接続で Open Client/Server CS_CON_KEEPALIVE プロパティ
を設定するかどうかを指定します。以下のいずれかの値を指
定します。
• 1 （デフォルト） CS_CON_KEEPALIVE プロパティが設定
されます。
• 0 CS_CON_KEEPALIVE プロパティは設定されません。
デフォルト値
KeepAlive=1
解説
KeepAlive は、 Sybase CT-Lib 接続プロパティ CS_CON_KEEPALIVE の
値を true または false に設定します。デフォルト設定では、接続がアイ
ドル状態のときにデータベースにパケットを送信することで、その接
続をアクティブにします。継続的な接続を保持しないモバイルクライ
アントに対しては、このプロパティの値を false に設定します。
例
接続を保持しない場合に KeepAlive 値を 0 に設定するには、以下の操
作を行います。
98
•
データベースプロファイル［ネットワーク］タブページの［接続を
保持する］チェックボックスをオフにします。
•
アプリケーション
コードに次のように入力します。
PowerBuilder
第1章
データベースパラメータの解説
SQLCA.DBParm="KeepAlive=0"
Language
機能
Language をサポートするインタフェースの場合、ターゲットデータ
ベースへの接続時に使用する言語を指定します。
Language を指定するタイミング
Language パラメータは、データベースに接続する前に指定します。
Language パラメータの設定は、データベースに接続した時点で有効に
なります。
対象
SYC Sybase Adaptive Server Enterprise
構文
Language = 'language_name'
デフォルト値
なし
解説
Language パラメータに値を指定すると、 PowerBuilder は以下の処理を
行います。
•
この接続に対して CS_LOCALE 構造体を割り当てます。
•
CS_SYB_LANG の値を、指定した言語に設定します。
•
SQL Server CS_LOC_PROP 接続プロパティに、新しいロケール情
報を設定します。
Locale パラメータは、 Open Client ソフトウェアが使用する言語や文字
セットを指定します。この Locale パラメータがすでに設定されている
場合、 Language パラメータに新しい値を指定し、データベースと再接
続することによって、言語の設定を変更します。
Unicode データアクセス PowerBuilder は、 Adaptive Server Enterprise
（ASE） 12.5 Unicode データベース中、または ASE 12.5 の Unicode カラ
ム中の Unicode データにアクセスすることができます。 PowerBuilder
は、 CharSet と Language パラメータで設定されている DBCS の値（ま
たは、 Locale パラメータで設定されている DBCS の値）に従って、 2
バイト文字コードセット（DBCS）データと Unicode データとを自動的
に変換します。
この例を以下に示します。
Language = 'japanese'
CharSet = 'sjis'
接続リファレンス
99
LCID
例
Language パラメータを French に設定するには、以下の操作を行いま
す。
DB プロファイル設定ダイアログボッ
クスの［地域の設定］タブで、［言語］ボックスに French と入力
します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="Language='French'"
関連項目
CharSet
Locale
LCID
機能
OLE DB データプロバイダが使用するロケール識別子を指定します。
LCID を指定するタイミング
LCID パラメータは、データベースに接続する前に指定します。
対象
OLE DB
構文
LCID = 'lcid_name'
デフォルト値
なし
解説
ロケール識別子は初期化時に指定します。これにより、データサーバ
が PowerBuilder の適切なロケール言語および文字セットを判断できる
ようになります。ただし、このパラメータを設定しても、 PowerBuilder
に返されるすべてのテキストがロケール ID に従って変換されるとは
限りません。
例
ロケールを日本語に設定するには、以下の操作を行います。
•
DB プロファイル設定ダイアログボッ
クスの［システム］タブで、［ロケール ID］ボックスに次のように
入力します。
データベースプロファイル
1041
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="LCID='1041'"
関連項目
100
CharSet
Language
PowerBuilder
第1章
データベースパラメータの解説
Locale
機能
PowerBuilder から Sybase Adaptive Server Enterprise データベースを介し
てアクセスするデータベースに接続するときに、 Sybase Open Client ソ
フトウェアが使用するロケール名を指定します。
Locale を指定するタイミング
Locale パラメータは、データベースに接続する前に指定します。
対象
SYC Sybase Adaptive Server Enterprise
構文
Locale = 'locale_name'
デフォルト値
LOCALES.DAT ファイルに定義されているデフォルトのロケール
解説
ロケールロケールは、 LOCALES.DAT ファイルのエントリとして格
納されています。 LOCALES.DAT ファイルには、 Sybase Open Client ソ
フトウェアが使用する言語と文字セットについての情報が定義されて
います。 Sybase Open Client ソフトウェアをインストールすると、
$SYBASE\LOCALES ディレクトリに LOCALES.DAT ファイルがイン
ストールされます。
LOCALES.DAT ファイルのエントリは、以下の書式で指定されていま
す。
locale = locale_name, language_name, character_set_name
この例を以下に示します。
locale = default, us_english, cp850
locale = enu, us_english, cp850
locale = fra, french, cp850
Locale パラメータの必要性 Locale パラメータに値を設定すると、
Adaptive Server Enterprise データベースにアクセスするときに、デフォ
ルトロケール以外のロケールを使用できます。 Locale の値が設定され
ていない場合、 Sybase Open Client では LOCALES.DAT ファイルに定義
されているデフォルトのロケールが使用されます。
設定後の処理 Locale パラメータに値を設定すると、 PowerBuilder は
以下の処理をします。
接続リファレンス
•
この接続に対して CS_LOCALE 構造体を割り当てます。
•
CS_LC_ALL の値を、指定したロケール名に設定します。
•
SQL Server CS_LOC_PROP 接続プロパティに、新しいロケール情
報を設定します。
101
Location
Locale パラメータの無効化 Locale パラメータは、使用する言語や文
字セットを指定します。この Locale パラメータがすでに設定されてい
る場合、Language または CharSet パラメータに新しい値を指定し、デー
タベースと再接続することによって、言語や文字セットの設定を変更
できます。
Unicode データアクセスデータウィンドウサーバは、 ASE 12.5
Unicode データベース中、または ASE 12.5 の Unicode カラム中の
Unicode データにアクセスすることができます。データウィンドウ
サーバは、 Language パラメータで設定されている DBCS の値に従っ
て、 2 バイト文字コードセット（DBCS）データと Unicode データとを
自動的に変換します。たとえば、 Locale パラメータは chs または cht に
設定されなければなりません。
例
ロケールを fra に設定するには、以下の操作を行います。
•
DB プロファイル設定ダイアログボッ
クスの［地域の設定］タブで、［ロケール］ボックスに次のように
入力します。
データベースプロファイル
fra
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="Locale='fra'"
設定後の処理 Locale パラメータを fra に設定した場合と、以下に示す
ように Language パラメータと CharSet パラメータを個別に設定した場
合の結果は同じです。
Language='French'
CharSet='cp850'
関連項目
CharSet
Language
Location
機能
OLE DB データプロバイダの接続先となるデータソースの場所を指定
します。多くの場合、このデータソースの場所はデータベースサーバ
名となります。
Location を指定するタイミング
Location パラメータは、データベースに接続する前に指定します。
102
PowerBuilder
第1章
データベースパラメータの解説
対象
OLE DB
構文
Location = 'location_name'
デフォルト値
なし
解説
Location パラメータの実装は、使用している OLE DB データプロバイ
ダによって異なります。詳細は、 OLE DB ベンダが提供するデータプ
ロバイダのマニュアルを参照してください。
Log
機能
データベースサーバに、テキストデータやイメージデータの更新内
容をトランザクションログに記録させるかどうかを指定します。デ
フォルトでは、テキストデータやイメージデータの更新内容が、デー
タベースサーバによってトランザクションログに記録されます。
対象
SYC および SYJ Sybase Adaptive Server Enterprise
構文
Log = value
パラメータ
value
説明
データベースサーバに、テキストデータやイメージデー
タの更新内容をトランザクションログに記録させるかどう
かを指定する値。以下のいずれかの値を指定します。
• 0 テキストやイメージの更新内容をトランザクション
ログに記録しません。使用しているデータベースサーバ
に、ログを取らない機能がある場合に限って、この値を
指定できます。
• 1 （デフォルト）テキストやイメージの更新内容をトラ
ンザクションログに記録します。
デフォルト値
Log = 1
解説
使用しているデータベースサーバで、ログを取らない機能がある場合
に限って、 Log パラメータを 0 に設定できます。
例
テキストやイメージの更新内容をトランザクションログに記録しな
いように指定するには、以下の操作を行います。
•
DB プロファイル設定ダイアログボッ
クスの［システム］タブの［テキストとイメージの更新ログを取
得］チェックボックスをオフにします。
•
アプリケーション
データベースプロファイル
コードに次のように入力します。
SQLCA.DBParm="Log=0"
接続リファレンス
103
LoginTimeOut
LoginTimeOut
機能
JDBC データベースまたは ODBC データソースへのログインリクエス
トの最大待ち時間を、秒単位で指定します。
対象
JDB JDBC
ODBC（ドライバおよびバックエンド DBMS がサポートしている場合）
構文
LoginTimeOut = value
パラメータ
value
説明
ドライバのログインリクエストに対する最大待ち時間を
指定する値
デフォルト値
ODBC: LoginTimeOut = 15; JDBC:LoginTimeOut = 0
解説
LoginTimeOut を 0 に設定した場合、PowerBuilder は LoginTimeOut 値を
設定するために JDBC または ODBC ドライバを呼び出さず、JDBC また
は ODBC ドライバのクライアントソフトウェアが指定した秒数の間待
機します。LoginTimeOut を 0 より大きい値に設定すると、PowerBuilder
は JDBC または ODBC ドライバを呼び出して LoginTimeOut 値を設定
します。
例
ログインリクエストの最大待ち時間が 60 秒になるように、LoginTimeOut
パラメータに値を設定するには、以下の操作を行います。
DB プロファイル設定ダイアログボッ
クスの［ネットワーク］タブで、［タイムアウト］ボックスに 60
と入力します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="LoginTimeOut=60"
MapDateToDateTime
機能
データの時間部分を取り出せるように Oracle Date データ型を DateTime
データ型にマップします。
対象
JDB JDBC
構文
MapDateToDateTime = value
104
PowerBuilder
第1章
パラメータ
value
データベースパラメータの解説
説明
Oracle Date データ型を DateTime データ型へマップするか
どうかを指定します。以下のいずれかの値を指定します。
• 0 （デフォルト） Oracle Date データ型を DateTime デー
タ型へマップしません。Date カラムの時間部分は取り出
されません。
• 1 Oracle Date データ型を DateTime データ型へマップ
します。 Date カラムの時間部分は取り出されます。
デフォルト値
MapDateToDateTime = 0
解説
Oracle Date データ型は日付と時間の両方のデータを格納します。
Oracle JDBC Thin Driver を使用して Oracle へ接続すると、データの日
付部分のみが取り出されます。データの時間部分を取り出すためには、
Oracle Date カラムのデータ型を DateTime データ型へマップするよう
に、 MapDateToDateTime データベースパラメータを設定します。
例
Oracle Date カラムから日付と時間の両方のデータを取り出すために
は、以下のように行います。
•
DB プロファイル設定ダイアログボッ
クスの［トランザクション］タブページにある［Date 型を DateTime
型にマップ］チェックボックスを選択します。
•
アプリケーション
データベースプロファイル
コードに次のように入力します。
SQLCA.DBParm = "MapDateToDateTime=1"
MaskPassword
機能
OLE DB データプロバイダへの接続時に、パスワードにマスクを自動
的にかけるようにするかどうかを指定します。
MaskPassword を指定するタイミング
MaskPassword パラメータは、データベースに接続する前に指定しま
す。
対象
OLE DB
構文
MaskPassword = 'value'
接続リファレンス
105
MaxConnect
パラメータ
value
説明
パスワードにマスクがかかるようにするかどうかを指定する
値。以下のいずれかの値を指定します。
• True PowerBuilder がパスワードにマスクをかけます。
• False （デフォルト） PowerBuilder はパスワードにマスクを
かけません。
デフォルト値
MaskPassword = 'False'
例
OLE DB データプロバイダへの接続時にパスワードにマスクがかかる
ようにするには、以下の操作を行います。
DB プロファイル設定ダイアログボッ
クスの［セキュリティ］タブで、［パスワードのマスク］チェック
ボックスをオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="MaskPassword='True'"
関連項目
DataLink
EncryptPassword
IntegratedSecurity
PersistEncrypted
MaxConnect
機能
データベースにアクセスするときの最大同時接続数を設定します。
同時接続のデフォルト数は 25 です。デフォルト数は、 MaxConnect を
設定することで、データベースサーバで設定された同時接続の最大数
まで更新することができます。
MaxConnect を指定するタイミング
MaxConnect パラメータの値は、データベースに接続する前に指定しま
す。
対象
SYC Sybase Adaptive Server Enterprise
構文
MaxConnect = value
パラメータ
value
106
説明
データベースにアクセスするための同時接続の最大数
PowerBuilder
第1章
データベースパラメータの解説
デフォルト値
MaxConnect = 25
解説
SYC MaxConnect は、Sybase CT-Lib 接続プロパティ CS_MAX_CONNECT
を、 1 つの CT-Lib コンテキストに対して指定された同時接続データ
ベースの数に設定します。
例
MaxConnect 値を最大同時接続数 50 に設定するには、以下の操作を行
います。
［Client Library の最大接続数］ボックス
に 50 と入力します。このチェックボックスは［ネットワーク］タ
ブにあります。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="MaxConnect=50"
MaxFetchBuffer
機能
データウィンドウオブジェクトがデータベースから行をフェッチす
るバッファの最大サイズを設定します。 Block パラメータと一緒に
MaxFetchBuffer パラメータを使用すると、 PowerBuilder でデータベー
スにアクセスする際のパフォーマンスが向上します。
対象
O84 Oracle 8.x および Oracle8i
O90 Oracle9i
O10 Oracle 10g
構文
MaxFetchBuffer = buffersize
パラメータ
buffersize
デフォルト値
説明
フェッチバッファが保持できるバイト数
5000000 ( バイト )
デフォルトバッファサイズの使用
MaxFetchBuffer にはデフォルト値以外を設定する必要はないはずで
す。たいていの場合、デフォルトのバッファサイズで要求を満たしま
す。
解説
接続リファレンス
Block データベースパラメータと一緒に MaxFetchBuffer データベース
パラメータを使用すると、行のサイズが非常に大きい場合にパフォー
マンスが向上します。
107
MixedCase
実際のフェッチバッファのサイズは、ブロックファクタの値に行のサ
イズを掛けた値になります。ブロックファクタが要求するフェッチ
バッファと行サイズが MaxFetchBuffer の値より大きい場合は、ブロッ
クファクタの値がバッファを超えないように調整しまます。
たとえば、 block = 500 で行サイズが 10KB の場合は、フェッチバッ
ファは 5000KB になり、デフォルトの最大バッファサイズに等しくな
ります。
データベース接続後に、コードで動的に Block および MaxFetchBuffer
を設定することができます。 MaxFetchBuffer は、 DB プロファイル設定
ダイアログボックスでは設定できません。
例
次の例では、最大フェッチバッファサイズを 6000KB に、ブロック
ファクタを 500 に設定します。
SQLCA.DBParm = "MaxFetchBuffer=6000000,block=500"
関連項目
Block （ODBC、 OLE DB、 Oracle）
MixedCase
機能
Oracle データベースとの接続において、大文字と小文字を区別するか
どうかを指定します。
デフォルトでは、 MixedCase パラメータが 0 に設定されます。デフォ
ルト設定では、大文字と小文字を区別しない接続が指定され、識別子
がすべて大文字として扱われます。 Oracle への接続時に大文字と小文
字が区別されるようにするには、 MixedCase パラメータに 1 を設定し
ます。
対象
O84 Oracle8i
O90 Oracle9i
O10 Oracle 10g
構文
MixedCase = value
パラメータ
value
108
説明
Oracle データベースとの接続で大文字と小文字を区別する
かどうかを指定する値。以下のいずれかの値を指定します。
• 0 （デフォルト） Oracle データベースとの接続で、大文
字と小文字を区別しません。すべての識別子が大文字と
して扱われます。
• 1 Oracle データベースとの接続で、大文字と小文字を区
別します。大文字、小文字、または大文字と小文字が混
在した識別子がサポートされます。
PowerBuilder
第1章
データベースパラメータの解説
デフォルト値
MixedCase = 0
解説
MixedCase パラメータを 1 に設定した状態で、 Oracle データベース上
のテーブルに対して主キーを定義する場合、以下の英文識別子はすべ
て大文字にします。
例
•
主キーの名前
•
主キーとテーブルの名前
•
主キーを参照するすべての外部キーの名前
Oracle データベースとの接続で識別子の大文字と小文字を区別するよ
うに指定するには、以下の操作を行います。
DB プロファイル設定ダイアログボッ
クスの［接続］タブで、［大文字小文字の区別］チェックボックス
をオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="MixedCase=1"
Mode
機能
OLE DB データプロバイダへのアクセス権限を指定します。
Mode を指定するタイミング
Mode パラメータは、データベースに接続する前に指定します。
対象
OLE DB
構文
Mode = 'value'
接続リファレンス
109
MsgTerse
パラメータ
value
説明
OLE DB データプロバイダへのアクセス権限を指定する値。以
下のいずれかの値を指定します。
• Deny read share ほかのユーザが読み込みモードで開くの
を禁止します。
• Deny write share ほかのユーザが書き込みモードで開くこ
とを禁止します。
• Exclusive share ほかのユーザが読み込み / 書き込みモード
で開くことを禁止します。
• No share deny ほかのユーザは、読み込みアクセスも書き
込みアクセスも拒否されません。
• Read/Write 読み込み / 書き込みアクセスを許可します。
• Read-only 読み込みアクセスを許可します。
• Write-only 書き込みアクセスを許可します。
デフォルト値
なし
例
OLE DB データプロバイダへの読み込み / 書き込みアクセスをほかの
ユーザに許可するには、以下の操作を行います。
•
DB プロファイル設定ダイアログボッ
クスの［トランザクション］タブで、［モード］リストボックスの
「Read/Write」を選択します。
•
アプリケーション
データベースプロファイル
コードに次のように入力します。
SQLCA.DBParm="MODE='DB_MODE_READWRITE'"
関連項目
DataLink
MsgTerse
機能
JDBC または ODBC ドライバが、簡略化したエラーメッセージを表示
するかどうかを指定します。簡略化したエラーメッセージとは、エ
ラーテキストから SQLSTATE の値を示す SQLSTATE = nnnn （nnnn は
エラー番号を表します）という表示を省いたエラーメッセージです。
デフォルトでは、 SQLSTATE を表示する JDBC および ODBC エラー
メッセージが表示されます。 SQLSTATE の表示を省いたエラーメッ
セージを表示するには、 MsgTerse パラメータを 'Yes' に設定します。
対象
JDB JDBC
ODBC
構文
MsgTerse = 'value'
110
PowerBuilder
第1章
パラメータ
value
データベースパラメータの解説
説明
SQLSTATE の表示を省いたエラーメッセージを表示する
かどうかを指定する値。以下のいずれかの値を指定します。
• Yes SQLSTATE の表示を省いたエラーメッセージを表
示します。
• No （デフォルト） SQLSTATE を表示するエラーメッ
セージを表示します。
デフォルト値
MsgTerse = 'No'
解説
MsgTerse パラメータに 'Yes' を設定することによって、簡略化した
JDBC または ODBC エラーメッセージを表示できます。エラーメッ
セージを表示するスクリーンの大きさに制限がある場合、この設定は
たいへん効果的です。
たとえば、 PowerBuilder のデータパイプラインを使用して、 Adaptive
Server Anywhere ODBC データベースに対するパイプライン処理をする
ときに、エラーが発生したものとします。 MsgTerse パラメータが 'No'
（デフォルト値）に設定されていると、以下に示すように、 SQLSTATE
（SQLSTATE = 23000）という表示を伴うパイプラインエラーが、デー
タパイプラインダイアログボックスに表示されます。
Adaptive Server Anywhere データベースのデータベースプロファイル
に MsgTerse ='Yes' を指定すると、以下に示すように、データパイプラ
インにおいて、SQLSTATE の表示を省いた ODBC エラーメッセージが
表示されます。
データパイプラインの使い方については、『PowerBuilder ユーザーズ
ガイド』マニュアルを参照してください。
例
SQLSTATE 表示が省かれたエラーメッセージが表示されるように指
定するには、以下の操作を行います。
DB プロファイル設定ダイアログボッ
クスの［システム］タブで、［簡易エラーメッセージの表示］チェッ
クボックスをオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="MsgTerse='Yes'"
Namespace
機能
接続リファレンス
データへのアクセス時に使用する .NET Framework データプロバイダ
を指定します。
111
NCharBind
Namespace を指定するタイミング
Namespace パラメータは、データベースに接続する前に指定します。
対象
ADO.NET
構文
Namespace = 'value'
パラメータ
value
説明
ADO.NET 接続のデータプロバイダとして使用する名前
空間を指定します。ドロップダウンリストから、サポー
トされる名前空間を選択できます。
デフォルト値
なし
解説
指定された DBMS の .NET Framework データプロバイダによって、
データソースにアクセスするために使用されるクラスのコレクショ
ンが管理空間内にこの書式で定義されます。
例
PowerBuilder で System.Data.OleDb 名前空間を使用してデータベースに
接続することを指定するには、以下の操作を行います。
•
DB プロファイル設定ダイアログボッ
クスの［接続］タブで、［名前空間］ドロップダウンリストの
「System.Data.OleDb」を選択します。
•
アプリケーション
データベースプロファイル
コードに次のように入力します。
SQLCA.DBParm="Namespace='System.Data.OleDb'"
NCharBind
機能
PowerBuilder が、プログラム内の文字列変数を Oracle Char データ型と
Oracle NChar データ型のどちらの内部変数にバインドするかを指定し
ます。
対象
O90 Oracle9i
O10 Oracle 10g
構文
NCharBind = value
112
PowerBuilder
第1章
パラメータ
value
データベースパラメータの解説
説明
PowerBuilder が、プログラム内の文字列変数を Char
データ型と NChar データ型のどちらの内部変数にバ
インドするかを指定します。以下のいずれかの値を指定
します。
0 （デフォルト） PowerBuilder は文字列データを Char
データ型でバインドします。
• 1 PowerBuilder は文字列データを NChar データ型でバ
インドします。
•
デフォルト値
NCharBind=0
解説
デフォルトでは、 Oracle ドライバは以下のようなステートメントで文
字列パラメータを Char データ型でバインドします。
dw_1.Retrieve("stringvalue")
// データウィンドウでデータを修正
dw_1.Update() // 文字列値を更新
// 埋め込み SQL
update tbl set col1 = :strVar1 where col2 = :strVar2;
文字列パラメータが NChar または NVarChar2 データ型を持つ場合は、
このようなステートメントを実行する前に、 NCharBind データベース
パラメータを 1 に設定します。 NCharBind はいつでも設定できる動的
なパラメータです。
NCharBind=1 の場合、 Oracle ドライバはすべての文字列パラメータを
NChar データ型を持つ内部変数にバインドします。文字列パラメータ
が Char および NChar または NVarChar2 の混在したデータ型を持つ場
合は、 NcharBind=1 を設定して NChar データが正しくバインドされる
ようにします。すべての文字列パラメータが Char データ型を持つ場合
は、 NcharBind=0 （デフォルト）を設定します。これは Char 変数を
NChar データ型としてバインドすると、 Oracle データベースドライバ
のパフォーマンスが大幅に低くなるからです。
開発環境で NChar をサポートする必要がある場合は、 NCharBind を 1
に設定して NChar データが正しく処理されるようにします。実行時に
NCharBind を動的に設定してパフォーマンスが低下しないようにしま
す。 NChar または NVarChar2 データを処理する前に NCharBind を 1 に
設定し、その後 0 に戻します。
例
接続リファレンス
文字列引数が NChar データ型としてバインドされるように指定するに
は、以下の操作を行います。
113
NLS_Charset
DB プロファイル設定ダイアログボッ
クスの［トランザクション］タブで、［NChar バインド］チェック
ボックスをオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "NCharBind=1"
NLS_Charset
機能
現行の環境ハンドルのためのクライアント側の文字セットを指定しま
す。
対象
O90 Oracle9i
O10 Oracle 10g
構文
NLS_Charset='value'
パラメータ
value
説明
現行の環境ハンドルのためのクライアント側の文字
セットを指定します。以下のいずれかの値を指定しま
す。
Unicode （デフォルト） OCI クライアントは、UTF-16 文
字セットを使用します。コネクションキャッシュを使用
して EAServer へ接続するときは、キャッシュのデータ
ベースドライバは OCI_9U である必要があります。
• Local OCI クライアントは、ローカルコンピュータの
NLS_LANG パラメータで定義された現行の文字セット
を使用します。コネクションキャッシュを使用して
EAServer へ接続するときは、キャッシュのデータベース
ドライバは OCI_9U である必要があります。
• ValidCharsetName AL16UTF16 以外の有効な文字セッ
ト名を指定します。 DB プロファイル設定ダイアログ
ボックスで値を指定するためには、［システム］ページ
の［NLS 文字セット］ドロップダウンリストボックス
に文字セット名を入力します。
•
デフォルト値
114
NLS_Charset='Unicode'
PowerBuilder
第1章
解説
データベースパラメータの解説
NLS_Charset の値を指定すると、 PowerBuilder は現行の接続に OCI
NLS_CHARACTERSET プロパティを設定します。
NLS_CHARACTERSET は、 CHAR、 VARCHAR2、 LONG、および
CLOB データ型を格納するために使用される文字セットエンコードを
指定するデータベースパラメータです。設定した値は、クライアン
ト側の NLS_LANG パラメータで定義された文字セットに対応づけら
れます。 NLS_LANG は、 OCI がアプリケーションとやり取りするテ
キストをエンコードする文字セットを定義します。 NLS_LANG は、
OCI がバインド中にアプリケーションに送ったり取得したりする文字
列や変数およびサーバで実行される SQL 構文で使用する文字セット
のエンコーディングを決定します。
Oracle の他国語文字セット NLS_NCHAR_CHARACTERSET の場合、
O10 と O90 データベースインタフェースは常に UTF-16 文字セットを
使用します。
EAServer 接続の場合、 Unicode または Local のみ使用可能です。 COM+
接続の場合は、 Local のみ使用可能です。
例
OCI クライアントが文字列を格納するデータ型として、ローカルコン
ピュータの NLS_LANG パラメータで定義された現行の文字セットを
使用するように指定するためには、以下のようにします。
DB プロファイル設定ダイアログボッ
クスの［システム］ページにある［NLS 文字セット］ドロップダ
ウンリストから「Local」を選択します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="NLS_Charset='Local'"
関連項目
StrByCharset
NumbersInternal
機能
データベースから数値を取得する際に OCI 文字列のかわりに Oracle の
内部 21 バイトバイナリ NUMBER データ型書式が使用されるように
指定します。 EBCDIC 文字セットまたは、ほかの非 ASCII 文字セット
を使って設定されている Oracle データベースにアクセスする場合にの
み、 NumbersInternal パラメータを使うのが適切です。
NumbersInternal を指定するタイミング
NumbersInternal パラメータは、データベースに接続する前に指定しま
す。
接続リファレンス
115
NumericFormat
対象
O84 Oracle8i
O90 Oracle9i
O10 Oracle 10g
構文
NumbersInternal = value
パラメータ
value
説明
数値を取得する際に Oracle の内部 21 バイトバイナリ
NUMBER データ型書式が使用されるように指定します。以
下のいずれかの値を指定します。
• 0 （デフォルト）内部書式の数値を取得しません。
• 1 内部書式の数値を取得します。
デフォルト値
NumbersInternal = 0
解説
NumbersInternal パラメータを使うと、データベースから数値を取得す
る際に Oracle の内部 21 バイトバイナリ NUMBER データ型書式が使
用されるように指定できるほか、結果を解読するための内部アルゴリ
ズムも提供されます。
例
数値取得の際に Oracle の内部書式が使用されるように指定するには、
以下の操作を行います。
DB プロファイル設定ダイアログボッ
クスの［構文］タブで、［内部書式での数値の検索］チェックボッ
クスをオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="NumbersInternal=1"
NumericFormat
機能
DBMS またはバックエンドデータベースでサポートされている場合、
NumericFormat を設定すると、 SQL 構文の数値文字列を特別に書式化
するようにドライバに指示が出されます。この書式は、データウィン
ドウオブジェクト内に内部的に作成され、データベースに送信される
SQL 構文の数値の生成方法に影響します。
対象
JDB JDBC
ODBC
構文
構文は、アクセスしているバックエンド DBMS、数値文字列の書式化
のしかたによって異なります。
116
PowerBuilder
第1章
データベースパラメータの解説
Oracle データベースに対する典型的な構文の例を以下に示します。こ
こでは、小数点記号としてカンマを使用して、数値文字列を書式化し
ています（PowerBuilder で作成され、データベースに送信される SQL
構文の数値書式の生成方法については、以下の「例」を参照してくだ
さい）。
PowerBuilder 開発環境では、 DB プロファイル設定ダイアログボック
スで、必要な場所に特殊文字（引用符）が挿入されるので、指定する
のは NumericFormat 値（この例の %s）だけでかまいません。
コードでは、以下の構文を使用する必要があります。
IBM DB2 構文 ODBC インタフェースを経由して IBM DB2 データベー
スにアクセスしている場合、以下の NumericFormat 構文を使用します。
文字列の前後に 1 つの単引用符が使用されている点に注意してくださ
い。
NumericFormat='%s,%s'
JDBC または ODBC インタフェースを経由し
て Oracle データベースにアクセスしている場合、以下の NumericFormat
構文を使用します。文字列の前後に 3 つの単引用符が使用されている
点に注意してください。
JDBC または ODBC 構文
NumericFormat = '''%s,%s'''
パラメータ
説明
'
IBM DB2 構文開始の単引用符を 1 つ入力します。開始の
単引用符は、 PowerBuilder で作成されデータベースに送信
される SQL 構文の中には返されませんが IBM DB2 データ
ベースでは必要とされます。
ORACLE 、 JDBC、 ODBC 構文開始の単引用符を 3 つ入力
します。 2 番目と 3 番目の引用符は、 PowerBuilder で作成さ
れ、データベースに送信される SQL 構文の中で、 1 つの開
始の単引用符として解析されます。
数値文字列の中の、小数点の左側の数値を表します。この
値は、 PowerBuilder が SQL 構文を作成するときに、小数点
の左側の数値に置き換えられます。
"'
%s
,
%s
接続リファレンス
小数点記号（この場合はカンマ）を表します。
数値文字列の中の、小数点の右側の数値を表します。この
値は、 PowerBuilder が SQL 構文を作成するときに、小数点
の右側の数値に置き換えられます。
117
NumericFormat
パラメータ
説明
'
IBM DB2 構文
終了の単引用符を 1 つ入力します。終了の
単引用符は、 PowerBuilder で作成されデータベースに送信
される SQL 構文の中には返されませんが、 IBM DB2 デー
タベースでは必要とされます。
ORACLE 、 JDBC、 ODBC 構文終了の単引用符を 3 つ入力
します。 1 番目と 2 番目の引用符は、 PowerBuilder で作成さ
れデータベースに送信される SQL 構文の中で、 1 つの終了
の単引用符として解析されます。
'''
デフォルト値
なし
解説
NumericFormat パラメータを設定する必要性一般に、 NumericFormat
パラメータを設定する必要はありません。大部分のバックエンド
DBMS では、ドライバに対して、 SQL 構文の数値文字列を特別に書式
化することを要求しません。ただし、特別な書式化を必要とするデー
タベース（たとえば、カンマを小数点記号として使用するように設定
されている IBM DB2/MVS データベースサーバなど）もあります。
この場合、 NumericFormat パラメータを設定すると、 PowerBuilder に
よってデータウィンドウオブジェクトの中に作成され、データベース
に送られる SQL 構文の中に、特別な書式の数値文字列を作成できま
す。たとえば、使用している DBMS の小数点記号がカンマの場合、以
下の「例」に示すように NumericFormat パラメータを設定することに
よって、データベースに送られる SQL 構文でカンマを小数点記号とし
て使用できます。
例
例 1 （IBM DB2 構文）次の例では、 125,50 と 4,0 という書式の 2 つの数
値が作成されるように指定する方法を示します。 PowerBuilder によっ
てデータウィンドウオブジェクトの中に作成され、 IBM DB2 データ
ベースに送信される SQL 構文の中では、カンマが小数点記号として使
用されます。
•
DB プロファイル設定ダイアログボッ
クスの［構文］タブで、［Numeric 型の書式］ボックスに次のよう
に入力します。
データベースプロファイル
%s,%s
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="NumericFormat='%s,%s'"
操作の結果 PowerBuilder は、データウィンドウオブジェクトの中に
次の SQL INSERT 文を内部的に作成して、データベースに送信します。
この SQL 構文の中には、単引用符が返されません。
INSERT INTO MYTABLE (a, b)
118
PowerBuilder
第1章
データベースパラメータの解説
VALUES (125,50, 4,0)
次の例では、 '125,50' と '4,0' と
いう書式の 2 つの数値が作成されるように指定する方法を示します。
PowerBuilder によってデータウィンドウオブジェクトの中に作成さ
れ、 Oracle データベースに送信される SQL 構文の中では、カンマが小
数点記号として使用されます。
例 2 （Oracle JDBC または ODBC 構文）
•
DB プロファイル設定ダイアログボッ
クスの［構文］タブで、［Numeric 型の書式］ボックスに次のよう
に入力します。
データベースプロファイル
%s,%s
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="NumericFormat='''%s,%s'''"
操作の結果 PowerBuilder は、データウィンドウオブジェクトの中に
次の SQL INSERT 文を内部的に作成して、データベースに送信します。
この SQL 構文の中には、単引用符が返されます。
INSERT INTO MYTABLE (a, b)
VALUES ('125,50', '4,0')
関連項目
DecimalSeparator
ObjectMode
機能
PowerBuilder は、 Oracle Call Interface （OCI）オブジェクトモードを解
除できます。デフォルトでは、 PowerBuilder は OCI アプリケーション
中の最初の OCI 呼び出しで、 OCIInitialize （）のモードパラメータを
OCI_OBJECT に設定します。オブジェクトモードが有効になっている
場合、アプリケーションは新規のデータベースオブジェクト型を定義
して使用することができます。しかし、アプリケーションが Oracle 8.1.7
データベースを使用している場合は、子 OCI 環境内で外部の OCI を実
行することはできません。オブジェクトモードが有効の時に、 Oracle
8.1.7 データベース中でクエリを実行するために外部 DLL を呼び出す
といったようなことはできません。
対象
O84 Oracle8i
O90 Oracle9i
O10 Oracle 10g
構文
ObjectMode = value
接続リファレンス
119
ODBCU_CONLIB
パラメータ
value
説明
オブジェクトモードを有効にするかしないかを指定しま
す。以下のいずれかの値を指定します。
• Yes （デフォルト）オブジェクトモードを使用します。
• No オブジェクトモードを使用しません。
デフォルト値
Yes
解説
オブジェクトモードを無効にするためには、 DB プロファイル設定ダ
イアログボックスの［接続］タブで、［オブジェクトモード］ボック
スのチェックを外すか、スクリプト中で ObjectMode に "No" を設定し
ます。
例
オブジェクトモードを無効にするには、以下の操作を行います。
DB プロファイル設定ダイアログボッ
クスの［接続］タブで［オブジェクトモード］チェックボックス
のチェックを外します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="ObjectMode='No'"
ODBCU_CONLIB
機能
EAServer が ODBC 接続キャッシュを ANSI または Unicode のいずれの
モードで確立するかを指定します。
このパラメータは、PowerBuilder カスタムクラスユーザオブジェクト
または JSP ページが EAServer に配布される場合だけ使用します。
対象
ODBC
構文
ODBCU_CONLIB = value
パラメータ
value
デフォルト値
120
説明
EAServer が ODBC 接続キャッシュを ANSI または Unicode
のいずれのモードで確立するかを指定します。以下のいず
れかの値を指定します。
• 0 （デフォルト） ANSI モードで接続を確立します。
• 1 Unicode モードで接続を確立します。
ODBCU_CONLIB = 0
PowerBuilder
第1章
データベースパラメータの解説
解説
このパラメータを 1 に設定して、 ODBC 接続を Unicode モードで確立
するための ODBCU に ODBC 接続キャッシュプロパティを設定する
必要があることを指定します。
例
Unicode 接続キャッシュを指定するには、以下の操作を行います。
DB プロファイル設定ダイアログボッ
クスの［EAServer/COM+］タブで、［Unicode 接続を有効］チェッ
クボックスをオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="ODBCU_CONLIB=1"
OJSyntax
機能
アクセス先データベースバックエンドで外部結合 SQL 構文をフォー
マットする方法を指定します。
対象
ADO.NET
Informix 9
JDB JDBC
ODBC
OLE DB
O90 Oracle9i
O10 Oracle 10g
SYC Sybase Adaptive Server Enterprise
構文
OJSyntax = value
パラメータ
value
デフォルト値
接続リファレンス
説明
SQL 構文のフォーマット方法を指定します。以下のいずれか
の値を指定します。
• ANSI_Escape ANSI 規格を適用し、外部結合をエスケー
プ表記 { oj ... } で囲みます。これにより、外部結合はドラ
イバによって解析された後、DBMS 固有の文法で置き換え
られます。
• ANSI ANSI 規格を適用します。
• PB PowerBuilder 10 に適用されている規則を遵守します。
OJSyntax = ANSI （IN9 および SYC の場合）、 OJSyntax = ANSI_ESCAPE
（ADO.NET、 JDBC、 ODBC、および OLE DB の場合）、 OJSyntax = PB
（O90 および O10 の場合）
121
OJSyntax
解説
PowerBuilder データベースインタフェースはすべて、 ANSI SQL-92 外
部結合 SQL 構文の生成をサポートしています。 PowerBuilder は、グラ
フィックスモードでは左外部結合と右外部結合の両方をサポートし、
構文モードでは完全外部結合と内部結合をサポートしています。
PowerBuilder に生成させる外部結合 SQL 構文のバージョンを明示する
には、 OJSyntax パラメータを設定する必要があります。 ADO.NET、
JDBC、 ODBC、および OLE DB の場合、デフォルトでは ANSI_Escape
が適用されますが、 ANSI または PB （ネイティブ）にリセットするこ
とも可能です。 IN9 および SYC の場合、デフォルトでは ANSI が適用
されますが、 PB にリセットすることも可能です。 O90 および O10 の
場合、デフォルトは PB であり、これは Oracle ネイティブの外部結合
構文を使用することを意味します。また、 ANSI にリセットすることも
可能です。
OJSyntax は、OJSyntax をサポートするデータベースドライバすべての
中にある動的パラメータです。つまり、次のようなステートメントを
使用したデータベース接続をしている間は、いつでも OJSyntax を変更
できます。
SQLCA.DBParm="OJSyntax='ANSI_ESCAPE' "
移植性の確保のためには、 SQL ペインタで外部結合を定義する SQL
ペインタで外部結合 SELECT 文をグラフィカルに定義した場合、デー
タウィンドウオブジェクトは SQL を擬似コードとして格納します。実
行時には、現在の OJSyntax パラメータ設定に基づいて、外部結合構文
が生成されます。これによって、複数の DBMS 内のデータウィンドウ
オブジェクトについて、ある程度の移植性を提供することが可能にな
ります。
外部結合 SELECT 文を構文モードで定義した場合、データウィンドウ
オブジェクトは SQL を構文として格納します。実行時は、この構文が
変更なしで使用されます。 OJSyntax パラメータの設定は、 SQL には影
響しません。
ネイティブ外部結合構文の使い方ネイティブ外部結合構文は、オプ
ションの PB を指定した場合に生成されます。
Sybase\Shared\PowerBuilder\pbodb100.ini ファイルの中の DBMS に対
応した SYNTAX セクションに PBOuterJoin 構文エントリと
PBOuterJoinOperator 構文エントリが設定されている場合にのみ、オプ
ションの PB を ODBC と OLE DB で使用できます。
122
PowerBuilder
第1章
データベースパラメータの解説
HKEY_CURRENT_USER\Software\Sybase\PowerBuilder\10.0\pbjdbc
キーの中の DBMS に対応したキーの Windows レジストリに PBOuterJoin
構文エントリと PBOuterJoinOperator 構文エントリが設定されている場
合にのみ、 PB オプションを JDBC で使用できます。このキーは、デ
フォルトではインストールされません。使用している DBMS に合わせ
て PowerBuilder JDBC 設定の追加や変更を行えるレジストリファイル
のサンプルについては、Sybase\Shared\PowerBuilder 内の egreg.txt ファ
イルを参照してください。
PowerBuilder 7 およびこれより前のバージョンの PowerBuilder からア
プリケーションを移行する場合、ANSI 外部結合の構文を使用している
と、ペインタでの結合定義の方法によっては、エラーが発生すること
があります。 1 つのテーブルが右外部結合により複数のテーブルに結
合されている場合、有効な ANSI 外部結合文を生成することはできま
せん。
外部結合についての詳細は、『PowerBuilder ユーザーズガイド』マニュ
アルの ANSI 外部結合の使い方に関するセクションを参照してくださ
い。
例
OJSyntax の値を設定するには、以下の操作を行います。
DB プロファイル設定ダイアログボッ
クスの［構文］タブの［Outer Join 構文］ドロップダウンリストか
ら適切な値を選択します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="OJSyntax='ANSI'"
OraMTSConFlgs
機能
COM+ に配布されたトランザクション用 PowerBuilder コンポーネント
の動作を指定します。このパラメータが適用されるのは、 PowerBuilder
カスタムクラスユーザオブジェクトを COM+ コンポーネントとして
配布し、このオブジェクトを Oracle 8.1.5 以降のデータベースに接続し
ている場合だけです。
対象
O84 Oracle8i （8.1.5 以降のデータベース接続のみ）
O90 Oracle9i
構文
OraMTSConFlgs = 'value'
接続リファレンス
123
OraMTSConFlgs
パラメータ
value
説明
COM+ に配布されたトランザクション用コンポーネントの動
作を指定します。以下のいずれかの値を指定します。
• All Default （デフォルト）プールされた接続を取得し、
COM+ トランザクション内にある接続を登録します。
（ORAMTS_CFLG_ALLDEFAULT）
• No Implicit Enlistment プールされた接続を取得しますが、
コンポーネントがトランザクション用でも COM+ トラン
ザクション内にあるリソースは登録しません。
（ORAMTS_CFLG_NOIMPLICIT）
• Unique Server Session OCI Server ごとに 1 つの OCI セッ
ションを要求します。バージョン 8.1.5 では多重化がサポー
トされていないため、常にこのオプションが使用されます。
（ORAMTS_CFLG_UNIQUESRVR）
• SYSDBA Login SYSDBA として接続している場合には必
要です。（ORAMTS_CFLG_SYSDBALOGN）
• SYSOPER Login SYSOPER として接続している場合には
必要です。（ORAMTS_CFLG_SYSOPRLOGN）
• Preliminary INTERNAL Login INTERNAL として接続して
いる場合には必要です。（ORAMTS_CFLG_PRELIMAUTH）
デフォルト値
OraMTSConFlgs = 'ORAMTS_CFLG_ALLDEFAULT'
解説
COM+ に配布されたトランザクション用 PowerBuilder コンポーネント
が O84 か O90 データベースインタフェースを使用して Oracle 8.1.5 以
降のデータベースに接続する場合、 COM+ はプールされた接続を取得
してその接続をトランザクション内に登録しようとします。別の動作
を指定することも可能です。その場合は、使用可能なオプションを 1
つまたは複数選択します。
Oracle O84 か O90 データベースインタフェースが COM+ で実行されて
いるときは、デフォルトで ThreadSafe モードが有効になり、 ThreadSafe
パラメータの値は無視されます。
このパラメータは、動的に設定することができません。接続の確立時
に設定された値は、接続が切断するまで有効です。
これらの値は、同時には指定できません。連鎖させる場合は、パラメー
タの中でパイプ文字を使用します。
COM+ トランザクションをサポートするための条件
COM+ の Oracle サービスをインストールおよび設定する必要がありま
す。
124
PowerBuilder
第1章
例
データベースパラメータの解説
INTERNAL アカウントを使用して、登録済みの接続を取得するには、
以下の操作を行います。
DB プロファイル設定ダイアログボッ
クスの［EAServer/COM+］タブで、［予備の INTERNAL ログイン］
チェックボックスをオンにします。［すべてデフォルト］チェック
ボックスは、デフォルトでオンになります。
•
データベースプロファイル
•
アプリケーションコードで以下の入力を行います（フラグの論理
和を指定するために｜を使用します）。
SQLCA.DBParm = "OraMTSConFlgs =
'ORAMTS_CFLG_ALLDEFAULT|ORAMTS_CFLG_PRELIMAUTH'"
PackageProcs
機能
Oracle データベースパッケージの中にカプセル化されているストアド
プロシージャと関数が、データウィンドウおよびデータベースペイン
タに表示される Oracle スタンドアロンストアドプロシージャおよび
関数のリストに追加されるように指定します。
PackageProcs を指定するタイミング
PackageProcs パラメータは、データベースに接続する前に指定します。
対象
O84 Oracle8i
O90 Oracle9i
O10 Oracle 10g
構文
PackageProcs = value
パラメータ
value
デフォルト値
接続リファレンス
説明
パッケージストアドプロシージャと関数を、ストアドプロ
シージャおよび関数のリストに追加するように指定します。以
下のいずれかの値を指定します。
• 0 （デフォルト）パッケージストアドプロシージャと関数
を追加しません。
• 1 パッケージストアドプロシージャと関数を追加します。
PackageProcs = 0
125
PacketSize （ODBC）
解説
パッケージとは、 Oracle データベース内に一緒に格納されている関連
プログラムオブジェクト（プロシージャ、関数、変数、およびカーソ
ルなど）のコレクションをカプセル化したものです。パッケージの中
に含まれているオブジェクトを一覧表示すると、 Oracle データベース
接続にパフォーマンス上のペナルティが課される可能性があります。
これらのオブジェクトをデータウィンドウペインタで表示すると、
REF CURSOR 文または SELECT 文のパラメータが含まれているオブ
ジェクトのみが一覧表示されます。データベースペインタで表示する
と、オブジェクト全部が一覧表示されます。表示されるテキストソー
スは、パッケージ全体のテキストソースです。
例
Oracle パッケージオブジェクトがストアドプロシージャおよび関数
のリストに追加されるように指定するには、以下の操作を行います。
•
DB プロファイル設定ダイアログボッ
クスの［システム］タブで、［パッケージサブプログラムをリスト
する］チェックボックスをオンにします。
•
アプリケーション
データベースプロファイル
コードに次のように入力します。
SQLCA.DBParm="PackageProcs=1"
PacketSize （ODBC）
機能
PowerBuilder の ODBC データソースにアクセスするときは、ネット
ワークパケットサイズをバイト単位で指定します。
バックエンド DBMS の多くは、 PacketSize オプションをサポートしな
いか、現行のネットワークパケットサイズを返すだけです。アクセス
している DBMS が PacketSize をサポートするかどうかについては、
DBMS のマニュアルを参照してください。
PacketSize を指定するタイミング
バックエンド DBMS が PacketSize をサポートする場合、 PacketSize パ
ラメータは、データベースに接続する前に指定します。
対象
ODBC（ODBC 2.0 以上のドライバおよびバックエンド DBMS がサポー
トしている場合）
構文
PacketSize = value
パラメータ
value
126
説明
バイト単位のネットワークパケットサイズを表す 32 ビット
の整数
PowerBuilder
第1章
データベースパラメータの解説
デフォルト値
PacketSize パラメータのデフォルト値は、バックエンド DBMS のデ
フォルト値です。
解説
指定した PacketSize の値が、最大ネットワークパケットサイズより大
きい場合、または最小ネットワークパケットサイズより小さい場合、
最大値または最小値が、指定した値に置き換えられます。
例
ODBC データソースに対するネットワークパケットサイズを、 2048
バイトに設定するには、以下の操作を行います。
DB プロファイル設定ダイアログボッ
クスの［ネットワーク］タブで、［パケットサイズ］ボックスに次
のように入力します。
データベースプロファイル
•
2048
アプリケーション
•
コードに次のように入力します。
SQLCA.DBParm="PacketSize=2048"
PacketSize （SYC）
機能
SQL Server データベースと接続するときに、 PowerBuilder アプリケー
ションとデータベースサーバ間での、データ転送のパケットのサイズ
をバイト単位で指定します。パケットとは、ネットワークを介して情
報を送る際の固定長のデータのかたまりです。
サーバの容量に制限がある場合、サーバはパケットサイズを
PacketSize パラメータで指定された値よりも小さく設定します。それ以
外の場合は PacketSize パラメータの値に設定します。デフォルト値は
512 バイトです。
PacketSize を指定するタイミング
PacketSize パラメータは、データベースに接続する前に指定します。
対象
SYC Sybase Adaptive Server Enterprise
構文
PacketSize = value
パラメータ
value
デフォルト値
接続リファレンス
説明
データベースサーバとアプリケーションとの間のデータ転
送におけるバイト単位のパケットサイズ。 512 の倍数を指定
します。デフォルト値は 512 バイトです。
PacketSize = 512
127
PBCatalogOwner
解説
設定が必要な場合 PowerBuilder のアプリケーションが、大量のテキ
ストやイメージデータをサーバとやりとりする場合、 PacketSize パラ
メータの値をデフォルトの 512 バイトよりも大きな値に設定すると、
ネットワーク上での読み込みや書き込み処理の回数が少なくなるの
で、パフォーマンスが向上します。
Adaptive Server Enterprise PacketSize パラメータを設定して Adaptive
Server Enterprise データベースで使用する前に、開発者またはシステム
管理者が以下の構成変数をサーバ上で設定して、PacketSize パラメータ
を有効にします。
この構成変数は、デフォルトサイズより大き
なネットワークパケットに対する付加的なメモリの最大サイズを
指定します。
•
Additional netmem
•
Maximum network packet size
この構成変数は、すべての SQL
Server ユーザに対する最大ネットワークパケットサイズを指定し
ます。
構成変数の設定については、 Sybase SQL Server のマニュアルを参照し
てください。
例
SQL Server データベースサーバのパケットサイズを、 2048 バイトま
たはそれよりも小さな値に設定するには、以下の操作を行います。
•
DB プロファイル設定ダイアログボッ
クスの［ネットワーク］タブで、［パケットサイズ］ボックスに次
のように入力します。
データベースプロファイル
2048
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="PacketSize=2048"
PBCatalogOwner
機能
拡張属性システムテーブルにデフォルト以外のオーナを指定します。
それら 5 種類のテーブルは、データベースのデフォルト拡張属性情報
を格納しています。
PBCatalogOwner パラメータに、 DBMS におけるデフォルトのオーナ以
外の名前を指定すると、そのオーナ名で、テーブルのセットが新しく
作成されます。
128
PowerBuilder
第1章
データベースパラメータの解説
PBCatalogOwner を指定するタイミング
PBCatalogOwner パラメータは、データベースに接続する前に指定しま
す。
対象
ADO.NET
JDB JDBC
ODBC
OLE DB
O84 Oracle8i
O90 Oracle9i
O10 Oracle 10g
SYC および SYJ Sybase Adaptive Server Enterprise
構文
PBCatalogOwner = 'owner_name'
パラメータ
owner_name
デフォルト値
PBCatalogOwner パラメータのデフォルト値は、次の表に示すように、
アクセスしている DBMS によって異なります。
DBMS
ADO.NET
JDBC
ODBC
接続リファレンス
説明
拡張属性システムテーブルのオーナ
DB2 データベースの場合 DB2SYSPB.SQL スクリプトを使
用して、 DB2 データベース内に拡張属性システムテーブ
ルを作成し、スクリプト内の PBOwner インスタンスをす
べてデフォルト以外のテーブルオーナ名で置き換える場
合、owner_name を DB2SYSPB.SQL スクリプトに指定され
ているオーナと同じ名前にしなければなりません。
PBCatalogOwner パラメータのデフォルト値
PBCatalogOwner の値がデータベースプロファイル
またはレジストリで指定されていない場合、データ
ベースプロファイルに指定されているユーザ ID
が、デフォルト値として使用されます。
PBCatalogOwner の値がデータベースプロファイル
またはレジストリで指定されていない場合、データ
ベースプロファイルに指定されているユーザ ID
が、デフォルト値として使用されます。
PBCatalogOwner の値が、データベースプロファイ
ルにも PBODBn0 初期設定ファイルにも指定されて
いない場合、データベースプロファイルに指定され
ているユーザ ID が、デフォルト値として使用され
ます。
129
PBCatalogOwner
DBMS
OLE DB
解説
PBCatalogOwner パラメータのデフォルト値
PBCatalogOwner の値がデータベースプロファイル
またはレジストリで指定されていない場合、データ
ベースプロファイルに指定されているユーザ ID
が、デフォルト値として使用されます。
Oracle
PBCatalogOwner = 'SYSTEM'
Sybase Adaptive Server
Enterprise
PBCatalogOwner = 'dbo'
設定が必要な場合拡張属性システムテーブルのオーナに、デフォル
ト以外のオーナを指定することによって、新たに別のテーブルを作成
することができます。この機能は、デフォルトテーブル内の現行の拡
張属性を変更することなく、新しい入力条件則や表示書式をテストす
るときに便利です。
JDBC データベース JDBC データベースに接続するとき、
PBCatalogOwner の値がデータベースプロファイルとレジストリの両
方で設定されている場合、プロファイルの設定がレジストリの設定よ
り優先されます。
ODBC データソース ODBC データソースに接続するとき、
PBCatalogOwner の値が、データベースプロファイルと PBODB100 初
期設定ファイルの両方に設定されている場合、プロファイル内の設定
が、 PBODB100 初期設定ファイルの設定より優先されます。
DB2 データベース DB2 データベースに接続する際には、
DB2SYSPB.SQL スクリプトを使用して拡張属性システムテーブルを
作成できます。 DB2SYSPB.SQL スクリプトを使用する場合は、以下
のことを念頭に置かなければなりません。
•
スクリプトを編集して PBOwner のインスタンスをすべて別の名前
に変更することも可能ですが、かわりにスクリプト内のテーブル
オーナを PBOwner （デフォルト）のままにしておくことも可能で
す。
SYSIBM は指定できない
SYSIBM をテーブルのオーナの名前として指定することはできま
せん。この指定は DB2 によって禁止されます。
•
130
PBCatalogOwner パラメータは、このスクリプトに指定されている
オーナに設定できますが、スクリプトが編集されていない場合は
PBOwner に設定できます。
PowerBuilder
第1章
データベースパラメータの解説
このパラメータは、動的に設定することができません。接続の確立時
に設定された値は、接続が切断するまで有効です。
例
以下の例は、 TEST というオーナで、新しい拡張属性システムテー
ブルを作成します。新しいテーブルの名前には、 TEST.pbcatcol や
TEST.pbcatedt などのように、 TEST という修飾子が付けられます。
•
DB プロファイル設定ダイアログボッ
クスの［システム］タブで、［PowerBuilder カタログテーブルオー
ナ］ボックスに次のように入力します。
データベースプロファイル
TEST
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="PBCatalogOwner='TEST'"
PBMaxBlobSize
機能
PowerBuilder がメモリに読み込むことができる最大の Blob サイズを指
定します。
PBMaxBlobSize を指定するタイミング
PBMaxBlobSize の値は、データベースに接続する前に指定します。
対象
ADO.NET
OLE DB
構文
PBMaxBlobSize = value
デフォルト値
PBMaxBlobSize=1024000 （ADO.NET および OLE DB）、
PBMaxBlobSize=32767 （ほかのインタフェースの場合）
解説
PowerBuilder は Blob の最大サイズを制限しません。 Blob の最大サイ
ズは、アプリケーションが動作しているマシンによって決まります。
Blob サイズが、アプリケーションが動作しているマシンの利用可能な
メモリ容量を超える場合、 PowerBuilder はデータプロバイダが
ISequentialStream インタフェースをサポートしていれば Blob をまとま
りで読み込みます。 Blob サイズがデフォルト値を超え、データプロバ
イダが ISequentialStream インタフェースをサポートしていない場合、
PowerBuilder は Blob の端を切り捨てて、メモリ不足エラーを報告しま
す。 PBMaxBlobSize パラメータは、 Blob の最大サイズを大きくするた
めに使用します。
例
PBMaxBlobSize 値を 200000 に設定するには、以下の操作を行います。
接続リファレンス
131
PBNewSPInvocation
•
DB プロファイル設定ダイアログボッ
クスの［トランザクション］タブで、［メモリ上の BLOB の最大サ
イズ］ボックスに次のように入力します。
データベースプロファイル
200000
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="PBMaxBlobSize=200000"
PBNewSPInvocation
機能
別の方法でストアドプロシージャを起動します。
対象
ODBC
構文
PBNewSPInvocation = 'value'
パラメータ
value
説明
ストアドプロシージャを起動するために標準的な方法ま
たは別の方法を使用するかどうかを指定します。以下のい
ずれかの値を指定します。
• No （デフォルト）標準的な方法でストアドプロシー
ジャを起動します。
• Yes 別の方法でストアドプロシージャを起動します。
デフォルト値
PBNewSPInvocation = 'No'
解説
埋め込み SQL コマンドを使用してストアドプロシージャを呼び出し
た場合は、出力パラメータが返されないことがあります。
PBNewSPInvocation を 'Yes' に設定すると、ストアドプロシージャを別
の方法で起動できます。このパラメータが設定されている場合、
PowerBuilder ODBC ドライバの動作は、OLE DB および JDBC ドライバ
のデフォルトの動作と同じです。
PBNewSPInvocation に 'Yes' を設定している場合は、ストアドプロシー
ジャを使用するデータウィンドウオブジェクトにデータを取得する
際に、別の方法が使用されます。このパラメータは、 RPC を使用して
ストアドプロシージャを起動するときは影響しません。
PBNewSPInvocation に 'Yes' を設定しているときは、PBUseProcOwner と
CallEscape の値は無視されます。
例
132
このパラメータをすべての接続に設定するには、pbodb100.ini ファイル
内の関連するセクション（たとえば、 Windows 上での DB2 接続の場合
は ;IBM DB2/NT 2.1 DB2CLI ）すべてに次の行を追加します。
PowerBuilder
第1章
データベースパラメータの解説
PBNewSPInvocation='Yes'
pbodb100.ini の編集の詳細については、『データベースとの接続』マニュ
アルの付録を参照してください。
このパラメータは実行時にも設定できます。この例を以下に示します。
SQLCA.DBParm="PBNewSPInvocation='Yes'"
実行時に設定した値によって、pbodb100.ini ファイル内の値は無効にな
ります。
ストアドプロシージャの出力パラメータの値を取得するには、OUTPUT
または OUT キーワードを使用します。この例を以下に示します。
DECLARE sp_test PROCEDURE FOR SP1 VAR0=:ARGIN,
VAR1=:ARGOUT OUTPUT USING SQLCA;
ストアドプロシージャに結果セットが含まれる場合は、先にその結果
セットをフェッチする必要があります。ストアドプロシージャに戻り
値があり、それを取得したい場合は、書式 RC=SP1 を使用します。
DECLARE sp_test PROCEDURE FOR RC=SP1 VAR0=:ARGIN,
VAR1=:ARGOUT OUTPUT USING SQLCA;
関連項目
DefaultProcOwner
PBNoCatalog
機能
実行時にデータウィンドウ
オブジェクトを作成するときに、
PowerBuilder がカタログテーブルの存在をチェックしないことを指定
します。
PBNoCatalog を指定するタイミング
データベースへ接続する前に、 PBNoCatalog パラメータを指定します。
対象
O84 Oracle 8.x および Oracle8i
O90 Oracle9i
O10 Oracle 10g
構文
PBNoCatalog='value'
パラメータ
value
接続リファレンス
説明
実行時にデータウィンドウオブジェクトを作成すると
きに、 PowerBuilder がカタログテーブルの存在を
チェックしないことを指定します。
133
PBTrimCharColumns
デフォルト値
PBNoCatalog = ‘NO’
解説
DBParm を使用して動的にデータウィンドウオブジェクトを作成し、
更新ストアドプロシージャを使用できるように修正した場合、
PowerBuilder は PowerBuilder のカタログテーブルを探します。
PBCatalogOwner を設定していない場合、オーナー SYSTEM の下にあ
るカタログテーブルを探します。作成されるデータウィンドウは
PBCatalogOwner が設定してあるかどうかにより異なり、オーナー
SYSTEM の下にテーブルが存在しない場合はエラーが生成されるかも
しれません。 PowerBuilder がカタログテーブルを使用しないようにす
るためには、 PBNoCatalog パラメータに true を設定します。
このパラメータは、 ODBC と OLE DB ドライバを介して Oracle へ接続
するための PBODB 初期設定ファイル（PBODBnnn.ini）でも設定する
ことが可能です。
このパラメータは、動的に設定することはできません。接続するとき
に設定した値は、接続を解除するまで影響が残ったままです。
例
PowerBuilder がカタログテーブルを使用しないようにするためには、
以下のようにコードに入力します。
SQLCA.DBParm="PBNoCatalog='Yes'"
関連項目
PBCatalogOwner
PBTrimCharColumns
機能
PowerBuilder が、次のデータ型 Char、 Char for Bit Data、 VarChar、およ
び VarChar for Bit Data から取り出されたデータ値から、後続スペース
を削除するかどうかを指定します。
対象
ODBC
OLE DB
構文
PBTrimCharColumns = value
パラメータ
value
デフォルト値
134
説明
PowerBuilder が、 Char、 Char for Bit Data、および VarChar
for Bit Data データ型から後続スペースを削除するかどうか
を指定します。以下のいすれかの値を指定します。
• NO （デフォルト）後続スペースを削除しません。
• YES 後続スペースを削除します。
'NO'
PowerBuilder
第1章
解説
データベースパラメータの解説
このパラメータは、 PBODBnnn.INI ファイルでのみ設定できます。
ODBC では、同じ働きをするように DB プロファイル設定ダイアログ
ボックスであるいはコードで TrimSpaces パラメータを設定できます。
デフォルトでは、 PowerBuilder は次のデータ型 Char、 Char for Bit Data、
VarChar、および VarChar for Bit Datatrims からスペースを削除しません。
WHERE 句の評価時に、後続スペース付きの CHAR データと後続ス
ペースなしの CHAR データを区別する DBMS を使用している場合、
データウィンドウの更新特性を「キーカラムおよび更新可能カラム」
に設定していると、「検索と更新の間に行が変更されました。」メッセージ
が表示されることがあります。このメッセージが表示されないように
するには、データウィンドウの更新特性を変更します。埋め込み SQL
の場合は、更新後に毎回 Sqlca.Sqlnrows をチェックすることにより、更
新が実際に実行されたかどうかを知ることができます。
PBTrimCharColumns='YES' の場合は、 UPDATE 文または DELETE 文の
WHERE 句で、 CHAR 型のデータカラムを使用することを避けてくだ
さい。
例
PowerBuilder で後続スペースを削除するように指定するには、アクセ
スするデータベースのセクションに以下の行を追加します。
PBTrimCharColumns='YES'
関連項目
TrimSpaces
PBUseProcOwner
機能
ODBC インタフェースを経由してデータベースにアクセスし、データ
ソースとしてストアドプロシージャを使用するデータウィンドウオ
ブジェクトを定義する場合に、ドライバに渡される SQL EXECUTE 文
の中のオーナ名を使ってストアドプロシージャを修飾するかどうか
を指定します。
ストアドプロシージャのオーナが、現行のユーザ（データウィンドウ
オブジェクトを作成している開発者、またはデータウィンドウオブ
ジェクトがあるアプリケーションを稼働しているエンドユーザ）の ID
と異なる場合に限って、ストアドプロシージャがオーナ名で修飾され
ます。
対象
ODBC
構文
PBUseProcOwner = 'value'
接続リファレンス
135
PBUseProcOwner
パラメータ
value
説明
データウィンドウオブジェクトで作成され、ドライバに
渡される SQL EXECUTE 文の中で、ストアドプロシー
ジャをオーナ名で修飾するかどうかを指定する値。以下
のいずれかの値を指定します。
• Yes ストアドプロシージャのオーナが現行のユーザ
ID と異なる場合、 SQL EXECUTE 文の中でストアド
プロシージャがオーナ名で修飾され、その情報がドラ
イバに渡されます。これによってユーザは、自分が
オーナでないストアドプロシージャも実行できます。
この例を以下に示します。
•
EXECUTE FRAN.MYPROCEDURE
（デフォルト）ドライバに渡されるデータウィン
ドウの SQL EXECUTE 文の中で、ストアドプロシー
ジャがオーナ名で修飾されません。この例を以下に示
します。
No
EXECUTE MYPROCEDURE
デフォルト値
PBUseProcOwner = 'No'
解説
PBUseProcOwner 値の判定 PowerBuilder は、以下の順序で検索を実行
し、 PBUseProcOwner 値を判定します。
1
使用しているデータベースプロファイルに対応する PowerBuilder
初期設定ファイルの中のセクション（開発環境の場合）、または
DBParm プロパティの値（アプリケーションの場合）
2
使用している ODBC ドライバに対応する、 PBODB100 初期設定
ファイルの中のセクション
これらの場所で PBUseProcOwner 値が見つからない場合、デフォルト
値の 'No' が適用されます。
DBA が Adaptive Server Anywhere ストアドプロシージャを所有する場
合 DBA （データベース管理者）は、 Adaptive Server Anywhere 構文の
予約語です。
データソースとして Adaptive Server Anywhere ストアドプロシージャ
を使用するデータウィンドウオブジェクトを定義したときに、DBA が
ストアドプロシージャのオーナの場合、 PBUseProcOwner 値が Yes に
設定されていると、以下の SQL EXECUTE 文が ODBC ドライバに渡さ
れます。
EXECUTE DBA.MYPROCEDURE
136
PowerBuilder
第1章
データベースパラメータの解説
このステートメントは、 DBA という予約語があるために、構文エラー
を生成します。
DBA がオーナである Adaptive Server Anywhere ストアドプロシージャ
を使用する場合、 PBUseProcOwner 値を No に設定すると、ストアドプ
ロシージャが DBA で修飾されないため、構文エラーを回避できます。
しかし、場合によっては、ストアドプロシージャを DBA オーナで修
飾する必要があります。 DBA が別のユーザ ID に実行権限を許可する
場合などがこれに相当します。この場合、データウィンドウで作成さ
れた SQL EXECUTE 文を編集し、DBA を引用符で囲むことによってエ
ラーを回避できます。
EXECUTE "DBA".MYPROCEDURE
例
SQL EXECUTE 文の中で、ストアドプロシージャがそのオーナ名で修
飾されるように指定するには、以下の操作を行います。
DB プロファイル設定ダイアログボッ
クスの［トランザクション］タブで、［ストアドプロシージャに
オーナ名を修飾］チェックボックスをオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="PBUseProcOwner='Yes'"
PersistEncrypted
機能
OLE DB インタフェースを介してアクセスしているデータソースが、
暗号化されたパスワードを保存できるかどうかを指定します。
PersistEncrypted を指定するタイミング
PersistEncrypted パラメータは、データベースに接続する前に指定しま
す。
対象
OLE DB
構文
PersistEncrypted = 'value'
パラメータ
value
接続リファレンス
説明
データソースが暗号化されたパスワードを保存できるかどう
かを指定する値。以下のいずれかの値を指定します。
• True データソースはパスワードを保存できます。
• False （デフォルト）データソースはパスワードを保存で
きません。
137
PersistSensitive
デフォルト値
PersistEncrypted = 'False'
例
OLE DB を介してアクセスしているデータソースがパスワードを保存
できるようにするには、以下の操作を行います。
DB プロファイル設定ダイアログボッ
クスの［セキュリティ］タブで、［暗号化パスワードの保持］チェッ
クボックスをオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="PersistEncrypted='True'"
関連項目
DataLink
MaskPassword
EncryptPassword
PersistSensitive
PersistSensitive
機能
OLE DB インタフェースを介してアクセスしているデータソースが、
パスワードなどの認証情報を保存できるかどうかを指定します。
PersistSensitive を指定するタイミング
PersistSensitive パラメータは、データベースに接続する前に指定しま
す。
対象
OLE DB
構文
PersistSensitive = 'value'
パラメータ
value
説明
データソースが認証情報を保存できるかどうかを指定する
値。以下のいずれかの値を指定します。
• True データソースが認証情報を保存できます。
• False （デフォルト）データソースは認証情報を保存でき
ません。
デフォルト値
PersistSensitive = 'False'
例
OLE DB を介してアクセスしているデータソースが認証情報を保存で
きるようにするには、以下の操作を行います。
138
PowerBuilder
第1章
データベースパラメータの解説
DB プロファイル設定ダイアログボッ
クスの［セキュリティ］タブで、［セキュリティ情報の保持］チェッ
クボックスをオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="PersistSensitive='True'"
関連項目
MaskPassword
EncryptPassword
PersistEncrypted
Properties
機能
データベースに接続するために使用している特定の JDBC ドライバに
固有のプロパティを設定します。
対象
JDB JDBC
構文
Properties = 'property_value'
デフォルト値
なし
解説
［ドライバ固有のプロパティ］ボックスでは、特定のドライバに固有の
プロパティを設定できます。
JDBC ドライバがサポートするプロパティについては、ベンダのマニュ
アルを参照してください。
ユーザ ID とパスワードの定義
プロパティが定義されている場合は、プロパティボックスでユーザ ID
とパスワードも定義する必要があります。
例
Sybase jConnect ドライバのプロパティを設定するには、以下の操作を
行います。
•
DB プロファイル設定ダイアログボッ
クスの［接続］タブで、［ドライバ固有のプロパティ］ボックスに
次のように入力します。
データベースプロファイル
SQLINITSTRING=set TextSize 32000;
user=sa;password=manager
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "Properties = 'SQLINITSTRING=set
TextSize 32000;user=sa;password=manager'"
接続リファレンス
139
ProtectionLevel
関連項目
Driver
URL
ProtectionLevel
機能
OLE DB データプロバイダを介して PowerBuilder とデータサーバの間
で送信されるデータに適用する保護のレベルを指定します。このパラ
メータは、 Remote Procedure Call （RPC）接続以外のネットワーク接続
だけに適用されます。認証された RPC 接続でも、同じようなレベルの
保護を指定できます。
ProtectionLevel を指定するタイミング
ProtectionLevel パラメータは、データベースに接続する前に指定しま
す。
対象
OLE DB
構文
ProtectionLevel = 'value'
パラメータ
value
デフォルト値
140
説明
PowerBuilder とデータサーバの間で送信されるデータに適用
する保護のレベルを指定する値。以下のいずれかの値を指定し
ます。
• Not set どのレベルの保護も選択されません。
• Call クライアントからサーバへの各リクエストの最初に
データのソースを認証します。
• Connect クライアントがサーバとの接続を確立したとき
にだけ認証を行います。
• None データの認証は実行されません。
• Packet 受信したすべてのデータがクライアントからのも
のであることを認証します。
• Packet （Integrity）受信したすべてのデータがクライアン
トからのものであり、途中でデータが変更されていないこ
とを認証します。
• Packet （Privacy）受信したすべてのデータがクライアント
からのものであり、そのデータが途中で変更されていない
ことを認証し、データを暗号化してデータのプライバシを
保護します。
Not set
PowerBuilder
第1章
例
データベースパラメータの解説
PowerBuilder とデータサーバの間で送信されるデータの保護のレベル
を設定するには、以下の操作を行います。
DB プロファイル設定ダイアログボッ
クスの［セキュリティ］タブで、［保護レベル］ドロップダウンリ
ストの「Connect」を選択します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm=
"PROTECTIONLEVEL='DB_PROT_LEVEL_CONNECT"
関連項目
DataLink
Provider
機能
データソースに接続するために使用するデータプロバイダを識別し
ます。
Provider を指定するタイミング
Provider パラメータは、データベースに接続する前に指定します。
対象
ADO.NET
OLE DB
構文
Provider = 'provider_name'
デフォルト値
なし
解説
［プロバイダ］ドロップダウンリストに表示される、インストール済
みデータプロバイダのリストからデータプロバイダを選択します。た
とえば、 Microsoft OLE DB Provider for ODBC を使用している場合は、
Provider 値として MSDASQL を選択します。Microsoft OLE DB Provider
for SQL Server を使用している場合は、 Provider 値として SQLOLEDB
を選択します。
詳細は、 OLE DB または ADO.NET ベンダが提供するデータプロバイ
ダのマニュアルを参照してください。
例
Microsoft OLE DB Provider for ODBC を使用して EAS Demo DB に
接続するには以下のようにします。
例1
•
接続リファレンス
OLE DB の DB プロファイル設定ダイ
アログボックスの［接続］タブで、［プロバイダ］ドロップダウン
リストの「MSDASQL」を選択します。
データベースプロファイル
141
ProviderString
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="Provider='MSDASQL'"
例 2 Microsoft OLE DB Provider for Oracle を使用して Oracle 8 データ
ベースに接続するには以下のようにします。
•
DB プロファイル設定ダイアログボッ
クスの［接続］タブで、［プロバイダ］ドロップダウンリストの
「MSDAORA」を選択します。
•
アプリケーション
データベースプロファイル
コードに次のように入力します。
SQLCA.DBParm="Provider='MSDAORA'"
例 3 Sybase Oracle8 ADO Provider を使用して Oracle 8 データベースに
接続するには以下のようにします。
ADO.NET の DB プロファイル設定ダ
イアログボックスの［接続］タブで、［プロバイダ］ドロップダウ
ンリストの「Sybase.Oracle8ADOProvider」を選択します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm =
"PROVIDER='Sybase.Oracle8ADOProvider'"
関連項目
DataLink
DataSource
ProviderString
機能
Microsoft SQL Server データベースに接続するときに、接続先のサーバ
上の特定のデータベースを識別します。
ProviderString を指定するタイミング
ProviderString パラメータは、データベースに接続する前に指定します。
対象
ADO.NET
OLE DB
構文
ProviderString = 'value'
デフォルト値
なし
解説
Microsoft SQL Server は 1 つのサーバでデータベースの複数のインスタ
ンスをサポートするので、データベース名を入力することで接続先の
特定のデータベースを識別する必要があります。
142
PowerBuilder
第1章
データベースパラメータの解説
詳細については、 Microsoft SQL Server のマニュアルを参照してくださ
い。
例
特定の Microsoft SQL Server データベースを識別するには、以下の操作
を行います。
•
OLE DB の DB プロファイル設定ダイ
アログボックスの［接続］タブの［拡張プロパティ］ボックスま
たは、 ADO.NET の［拡張プロパティ］ボックスに次のように入力
します。
データベースプロファイル
Database = demodb1
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="ProviderString='database=demodb1'"
関連項目
URL
ProxyUserName
機能
EAServer がプロキシを介して接続キャッシュから接続を取得するよう
に指定します。
このパラメータは、PowerBuilder カスタムクラスユーザオブジェクト
が EAServer コンポーネントとして配布される場合だけ使用します。
対象
JDB JDBC
ODBC
SYJ Sybase Adaptive Server Enterprise
構文
ProxyUserName = 'value'
パラメータ
value
説明
接続の使用が可能な代替ログイン名を指定します。
デフォルト値
なし
解説
キャッシュへのアクセスの際にユーザか名前のどちらを使用するかに
かかわらず、プロキシを介して接続を取得できます。プロキシを介し
て接続を取得した場合、代替ログイン名を入力することによって、別
のユーザの ID と権限を使用できます。
接続リファレンス
143
PWDialog
この機能は、 SQL コマンド set session authorization を認識するデータ
ベースで利用できます。ユーザ A が ProxyUserName パラメータを使用
して別のユーザ B の ID を使用できるようにするには、このステート
メントを実行する権限をユーザ A に付与しておく必要があります。た
とえば、 Adaptive Server Anywhere の場合は、 DBA 権限をユーザ A に
付与しておく必要があり、 Adaptive Server Enterprise の場合は、 set
session authorization を実行する権限をユーザ A に付与しておく必要
があります。
SYJ インタフェースの使用
Sybase EAServer では、わずかに異なるバージョンの CT-Lib ソフトウェ
アが使用されます。したがって、実行時に、 Adaptive Server Enterprise
データベースに接続するには SYC ではなく SYJ データベースインタ
フェースを使用する必要があります。 SYJ の DB プロファイル設定ダ
イアログボックスを使用すると、適切な接続パラメータが設定され、
構文を［プレビュー］タブからトランザクションオブジェクトのスク
リプトにコピーできます。
ただし、 PowerBuilder 開発環境からデータベースに接続する場合には
SYJ インタフェースを使用できません。したがって、開発段階では（コ
ンポーネントが EAServer に配布される前）、 SYC を使用してデータ
ベースに接続する必要があります。
PowerBuilder を使用して EAServer コンポーネントを作成し、プロキシ
設定の有効化をサポートする方法については、『アプリケーションテ
クニック』マニュアルを参照してください。
例
DB プロファイル設定ダイアログボックスの［EAServer］タブで、［プロ
キシユーザ名］ボックスに代替ログイン名を入力します。ProxyUserName
パラメータの PowerScript 構文が、次のように［プレビュー］タブに表
示されます。
SQLCA.DBParm = "ProxyUserName = 'pikachu'"
この構文を［プレビュー］タブからスクリプトにコピーします。
関連項目
CacheName
PWDialog
機能
実行時にユーザのパスワードの有効期限が切れた場合、アプリケー
ションでパスワードが期限切れですダイアログボックスを表示する
かどうかを制御します。
144
PowerBuilder
第1章
データベースパラメータの解説
PWDialog が 1 に設定されている場合、有効期限が切れたパスワードを
使ってデータベースにログインしようとすると、パスワードが期限切
れですダイアログボックスが表示され、ユーザに対してパスワードの
変更を求めます。デフォルトでは、 PWDialog は 0 に設定され、実行時
にアプリケーションでパスワードが期限切れですダイアログボック
スは表示されません。
PWDialog の設定値は、実行時にのみアプリケーションに影響します。
PowerBuilder 開発環境では、 PWDialog の設定値にかかわらず、パス
ワードの変更ダイアログボックスが表示され、ユーザに対して有効期
限が切れたパスワードの変更を求めるので、開発環境の場合は無効で
す。
PWDialog を指定するタイミング
PWDialog の値は、データベースに接続する前に指定します。
対象
O84 Oracle8i
O90 Oracle9i
O10 Oracle 10g
SYC Sybase Adaptive Server Enterprise
構文
PWDialog = value
パラメータ
value
説明
実行時に PowerBuilder アプリケーションでパスワードが
期限切れですダイアログボックスを表示し、ユーザに対
して有効期限の切れたログインパスワードを変更するよ
うに求めるかどうかを指定する値。以下のいずれかの値を
指定します。
• 0 （デフォルト）実行時にパスワードが期限切れです
ダイアログボックスを表示しません。
• 1 実行時にパスワードが期限切れですダイアログ
ボックスを表示し、ユーザに対して有効期限の切れた
パスワードを変更するように求めます。
デフォルト値
PWDialog = 0
解説
設定が必要な場合 PWDialog を 1 に設定し、アプリケーションでパス
ワードが期限切れですダイアログボックスが表示されるようにする
と、パスワードの有効期限が切れているため、変更が必要であること
をユーザに通知するのに便利です。
接続リファレンス
145
PWEncrypt
設定後の処理実行時にアプリケーションでパスワードが期限切れで
すダイアログボックスを表示する場合、ユーザに対して、ログイン ID
の有効期限が切れているために新しいパスワードの設定が必要である
ことが通知されます。たとえば、 Adaptive Server Enterprise の場合、
sp_password システムストアドプロシージャを実行して新しいパス
ワードを設定します。パスワードの変更が完了したら、データベース
に接続できるようになります。
ユーザが、パスワードを変更しないままで［キャンセル］ボタンをク
リックしてパスワードが期限切れですダイアログボックスを閉じた
場合は、データベース接続は失敗し、パスワードの期限切れを知らせ
るメッセージが表示されます。
例
実行時にアプリケーションで必要な場合にパスワードが期限切れです
ダイアログボックスが表示されるようにするには、以下の操作を行い
ます。
•
データベースプロファイル PWDialog の設定値は、開発環境では無
効ですが、データベースプロファイルで設定すると、対応する
PowerScript 構文が［プレビュー］タブに生成されるため、そこか
ら構文をコードへコピーすることができます。DB プロファイル設
定ダイアログボックスの［接続］タブで、［パスワード期限切れダ
イアログの表示］チェックボックスをオンにします。
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="PWDialog=1"
PWEncrypt
機能
PWEncrypt には、 PowerBuilder から Sybase Adaptive Server Enterprise
データベースに接続する際に Open Client に自動的にパスワードを暗
号化させるかどうかを指定します。
PWEncrypt を指定するタイミング
PWEncrypt パラメータは、データベースに接続する前に指定します。
対象
SYC Sybase Adaptive Server Enterprise
構文
PWEncrypt = 'value'
146
PowerBuilder
第1章
パラメータ
value
データベースパラメータの解説
説明
Open Client ソフトウェアがパスワードを暗号化するかどうか
を指定する値。以下のいずれかの値を指定します。
• Yes （デフォルト） CS_SEC_ENCRYPTION 接続プロパティ
を CS_TRUE に設定して、 Open Client がパスワードを暗号
化するように指定します。
• No CS_SEC_ENCRYPTION 接続プロパティを CS_FALSE
に設定して、 Open Client がパスワードを暗号化しないよう
に指定します。
デフォルト値
PWEncrypt = 'Yes'
例
PowerBuilder から Sybase Adaptive Server Enterprise データベースに接続
するときに、Open Client がパスワードを暗号化しないようにするには、
以下の操作を行います。
DB プロファイル設定ダイアログボッ
クスの［ネットワーク］タブで、［パスワードの暗号化］チェック
ボックスをオフにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "PWEncrypt='No'"
PWExpDialog
機能
実行時にユーザのパスワードの有効期限が間もなく切れる場合に、そ
のことを伝えるダイアログボックスを表示するかどうかを制御しま
す。
PWExpDialog が 1 に設定されている場合は、パスワードの有効期限が
間もなく切れることを知らせるダイアログボックスが表示されます。
デフォルトでは、 PWExpDialog は 0 に設定され、実行時にアプリケー
ションでダイアログボックスは表示されません。
PWExpDialog を指定するタイミング
PWExpDialog の値は、データベースに接続する前に指定します。
対象
O84 Oracle8i
O90 Oracle9i
SYC Sybase Adaptive Server Enterprise
構文
PWExpDialog = value
接続リファレンス
147
QualifyPublic
パラメータ
value
説明
アプリケーションの実行時に、ログインパスワードの有
効期限が間もなく切れることを知らせるダイアログボッ
クスを表示するかどうかを指定します。以下のいずれかの
値を指定します。
• 0 （デフォルト）実行時にダイアログボックスを表示し
ません。
• 1 実行時にダイアログボックスを表示します。
デフォルト値
PWExpDialog = 0
解説
このパラメータが 1 に設定されている場合、 Oracle ORA-28002、 ORA28011、および Adaptive Server 4023 情報メッセージが表示されます。
例
必要に応じてダイアログボックスを表示するには、以下の操作を行い
ます。
SQLCA.DBParm = "PWExpDialog=1"
QualifyPublic
機能
パブリックスキーマまたはユーザグループに属す Oracle シノニムに
付加された PUBLIC 修飾子が、 SQL Select テーブルリスト内に保持さ
れるように指定します。
QualifyPublic を指定するタイミング
QualifyPublic パラメータは、データベースに接続する前に指定します。
対象
O84 Oracle8i
O90 Oracle9i
O10 Oracle 10g
構文
QualifyPublic = value
パラメータ
value
デフォルト値
148
説明
PUBLIC 修飾子が SQL Select テーブルリスト内に保持され
るように指定します。以下のいずれかの値を指定します。
• 0 （デフォルト） PUBLIC 修飾子を保持しません。
• 1 PUBLIC 修飾子を保持します。
QualifyPublic = 0
PowerBuilder
第1章
データベースパラメータの解説
解説
PowerBuilder のデフォルト動作により、PUBLIC 修飾子を破棄して生成
済みの SQL 文でオブジェクト参照を一般化することができ、開発デー
タベースインスタンスからプロダクションデータベースにアプリ
ケーションを容易に配布できます。ただし、一部のデータウィンドウ
オブジェクトでは、 PUBLIC 修飾子が存在しない場合は拡張属性とシ
ノニムの関連付けを解除し、拡張属性が使用されるのを回避します。
QualifyPublic パラメータを使うと、 PUBLIC 修飾子を保持する必要が
あるかどうかを指定できます。
例
PUBLIC 修飾子が SQL Select テーブルリスト内に保持されるように指
定するには、以下の操作を行います。
DB プロファイル設定ダイアログボッ
クスの［システム］タブで、［パブリックシノニムを修飾する］
チェックボックスをオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "QualifyPublic=1"
RecheckRows
機能
INSERT、 UPDATE、または DELETE コマンドの影響を受ける行数を再度
チェックし、トランザクションオブジェクトの SQLNRows プロパティ
にそれを返します。
対象
ADO.NET
OLE DB
構文
RecheckRows = value
パラメータ
value
デフォルト値
接続リファレンス
説明
Microsoft SQL Server @@rowcount プロパティの値をチェッ
クし、トランザクションオブジェクトの SQLNRows プロ
パティに返すかどうかを指定します。以下のいずれかの値
を指定します。
• 0 （デフォルト）影響を受ける行数を再チェックしませ
ん。
• 1 影響を受ける行数を再チェックします。
RecheckRows=0
149
Release
解説
Microsoft SQL server で、テーブルに挿入、更新、削除のトリガがある
場合、 INSERT、 UPDATE、 DELETE コマンドの後にトランザクションオ
ブジェクトの SQLNRows プロパティに返される影響を受ける行数は
ドライバに依存します。 ADO.NET ドライバでは、返される値はコマン
ド自体とトリガの影響を受ける行数です。
ADO.NET または OLE DB を使用して Microsoft SQL Server に接続する
場合、RecheckRows ランタイムデータベースパラメータに 1 を設定し
て、 INSERT、 UPDATE、または DELETE コマンド自体の影響を受ける
データの行数を再チェックし、 SQLNRows プロパティにその値を返す
ことができます。
INSERT、 UPDATE、
または DELETE
コマンドを発行する前に
RecheckRows に 1 を設定すると、 SELECT @@ROWCOUNT コマンドが
実行されます。パフォーマンスを改善するために、必要なときにのみ
設定して、使用後はデフォルト値 0 に再設定します。
例
RecheckRows に 1 を設定するためには、コードに次のように入力しま
す。
SQLCA.DBParm="RecheckRows=1"
Release
機能
クライアントワークステーション上で使用する Sybase Open Client
Client-Library （CT-Lib）ソフトウェアのバージョンを指定します。
Release を指定するタイミング
Release の値は、データベースに接続する前に指定します。
対象
SYC Sybase Adaptive Server Enterprise
構文
Release = 'value'
150
PowerBuilder
第1章
パラメータ
value
データベースパラメータの解説
説明
アプリケーションで使用する Open Client Client-Library の
バージョンを指定します。
値は、クライアントにコンテキスト構造を割り当てるため
に使用される CS_VERSION プロパティの値に対応しま
す。下位互換性のために、同じクライアントコンテキス
トを指定する複数の値が存在します。以下のいずれかの値
を指定します。
• 10.x CS_VERSION_100
• 11 CS_VERSION_110
• 11.5 CS_VERSION_110
• 12 CS_VERSION_110
• 12.5 CS_VERSION_125
• 12.5.1 CS_VERSION_125
デフォルト値
Release='11'
解説
Release パラメータは、クライアントワークステーションにインストー
ルされた Open Client ソフトウェアのバージョンに対応している必要
があります。たとえば、 Adaptive Server のバージョンが 12.5 または
12.5.1 であっても、 Open Client のバージョンが 12.0 であれば、 12.5 ま
たは 12.5.1 とは指定しません。
Adaptive Server 15 を使用するには、クライアントコンピュータに Open
Client バージョン 15 をインストールして、 Release パラメータに 15 を
設定して、 Open Client 15 クライアントコンテキストを確立します。
Open Client コンテキストは、最初の PBSYC100.DLL データベース接続
によって割り当てられます。このコンテキストは、後続のすべての
PBSYC100.DLL 接続の親コンテキストとして機能します。したがって、
Release パラメータにはすべての接続で同じ値を指定する必要があり
ます。
接続リファレンス
151
Release
クライアントライブラリがロードされていないと、Release の値に対応
したバージョンがロードされます。Release の値が 15 で、そのバージョ
ンをクライアントで使用できない場合は、ライブラリはロードに失敗
します。 Release の値が 15 より小さく、そのバージョンが使用できな
い場合は、PBSYC100.DLL はクライアントライブラリのバージョン 15
をロードすることを試み、要求されたバージョンもバージョン 15 も使
用できない場合にのみ失敗します。アクティブなクライアントコンテ
キストがない場合は、 PBSYC100.DLL は Release パラメータの値を使
用して接続します。アクティブなクライアントコンテキストがある場
合は、Release パラメータの値が現行のクライアントコンテキストより
大きいと新しい接続は失敗します。 Release パラメータの値が現行のク
ライアントコンテキストと同じか小さい場合に、新しい接続は成功し
ます。
SYC ドライバは、動的にクライアントライブラリの該当するバージョ
ンにリンクし、すべての接続が閉じられる時に Open Client コンテキス
トが解放されます。複数の接続を開く場合は、最初に確立された Open
Client コンテキストがすべての接続で使用されます。開発環境で新し
い Open Client コンテキストを確立する必要がある場合は、すべての開
いている接続を閉じ、必要とするコンテキストに Release パラメータで
新しい接続を確立します。
データベースにログインするごとに、アクセスする Adaptive Server のバー
ジョンは PBSYC100.DLL によって自動的に決まります。 PBSYC100.DLL
は、 Adaptive Server のバージョンと Release パラメータに指定された
Open Client コンテキストとの組み合わせに対してパフォーマンスと機
能が最適化されるように動作をカスタマイズします。クライアント上
の Open Client ソフトウェアに対応していない値を Release に指定する
と、予想外の結果が生じる可能性があります。
値 12.5 と 12.5.1 は、共に Open Client 12.5 コンテキストを開きます。た
だし、 Open Client 12.5 を使用する場合は Release='12.5' と指定し、 Open
Client 12.5.1 を使用する場合は Release='12.5.1' と指定する必要があり
ます。これにより、 Open Client 12.5.1 と Adaptive Server 12.5.1 が必要と
なる以下の状況が PBSYC100.DLL によって適切に処理されます。
152
•
Adaptive Server 12.5.1 で導入された Date および Time データ型を、
ストアドプロシージャの引数リストでこれらのデータ型を明示的
に呼び出す RPC 呼び出しで使用する
•
Date および Time データ型を Update where current of および
Delete where current of 文で使用する
PowerBuilder
第1章
データベースパラメータの解説
Open Client ソフトウェアと Adaptive Server 12.5.1 を使用すれば、 Date
および Time データ型に対するデータウィンドウでの検索、更新、およ
び削除処理が正しく行われます。データベースペインタでは、 Open
Client コンテキスト内の Adaptive Server 12.5.1 サーバに接続すると、
Date および Time データ型はメタデータ型のリストに表示されます。
ほかの一部の機能は、関連のある Open Client ソフトウェアを使用し
て、指定されたバージョンの SQL Server 10/11 または Adaptive Server
Enterprise データベースにアクセスするときにのみサポートされます。
この例を以下に示します。
例
•
Release パラメータに 11 以上を設定し、 Open Client 11.x 以上と
Adaptive Server 11.x 以上を使用することで、アプリケーションで
ネットワークベースのセキュリティとディレクトリサービスを利
用します。
•
Release に 12.5 を設定し、 Open Client 12.5 以上と Adaptive Server
12.5 以上を使用することで、256 文字以上の文字が設定された Char
および VarChar カラムにアクセスします。
•
Release に 15 を設定し、 Open Client 15 以上と Adaptive Server 15 以
上を使用することで、 Adaptive Server バージョン 15 で追加された
UNITEXT および 64-bit integer (BigInt) SQL データ型にアクセスし
ます。
PowerBuilder アプリケーションが Open Client Client-Library 15 のコンテ
キストを使用して Adaptive Server Enterprise 15 データベースにアクセ
スするように指定するには、以下の操作を行います。
DB プロファイル設定ダイアログボッ
クスの［接続］タブで、［リリース］ドロップダウンリストの「15」
を選択します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm="Release='15'"
ReleaseConnectionOption
機能
接続の制御を解放するときの EAServer の動作を指定します。このパラ
メータが適用されるのは、 PowerBuilder カスタムクラスユーザオブ
ジェクトが EAServer コンポーネントとして配布される場合だけです。
対象
JDB JDBC
ODBC
O84 Oracle8i
接続リファレンス
153
ReleaseConnectionOption
O90 Oracle9i
SYJ Sybase Adaptive Server Enterprise
構文
ReleaseConnectionOption = 'value'
パラメータ
value
説明
接続の制御を解放するときの EAServer の動作を指定する
値。以下のいずれかの値を指定します。
• JAG_CM_UNUSED （デフォルト）キャッシュからの接
続はキャッシュに戻され、キャッシュ外で作成された
接続は閉じられ、破棄されます。
• JAG_CM_DROP 接続は強制的に閉じられ、割り当てが
解除されます。接続がキャッシュからの場合は、新し
い接続がその位置に作成されます。
デフォルト値
ReleaseConnectionOption = 'JAG_CM_UNUSED'
解説
UAG_CM_DROP を使用すると、エラーによって接続が使用不可になっ
たときにその接続が破棄されます。このパラメータは、動的に設定す
ることができません。接続の確立時に設定された値は、接続が切断す
るまで有効です。
SYJ インタフェースの使用
Sybase EAServer では、わずかに異なるバージョンの CT-Lib ソフトウェ
アが使用されます。したがって、実行時に、 Adaptive Server Enterprise
データベースに接続するには SYC ではなく SYJ データベースインタ
フェースを使用する必要があります。 SYJ の DB プロファイル設定ダ
イアログボックスを使用すると、適切な接続パラメータが設定され、
構文を［プレビュー］タブからトランザクションオブジェクトのスク
リプトにコピーできます。
ただし、 PowerBuilder 開発環境からデータベースに接続する場合には
SYJ インタフェースを使用できません。したがって、開発段階では（コ
ンポーネントが EAServer に配布される前）、 SYC を使用してデータ
ベースに接続する必要があります。
PowerBuilder を使用して EAServer コンポーネントを作成する方法につ
いては、『アプリケーションテクニック』マニュアルを参照してくだ
さい。
例
154
DB プロファイル設定ダイアログボックスの［EAServer］タブで、［接
続解放オプション］ドロップダウンリストの「JAG_CM_DROP」を選
択します。 ReleaseConnectionOption パラメータの PowerScript 構文が、
次のように［プレビュー］タブに表示されます。
PowerBuilder
第1章
データベースパラメータの解説
SQLCA.DBParm = "ReleaseConnectionOption =
'JAG_CM_DROP'"
この構文を［プレビュー］タブからスクリプトにコピーします。
関連項目
CacheName
GetConnectionOption
UseContextObject
RPCRebind
機能
リモートプロシージャコール（RPC）パラメータが再バインドされる
ようにするかどうかを指定します。
RPCRebind を指定するタイミング
バックエンド DBMS が RPCRebind をサポートする場合、データベース
に接続する前に RPCRebind パラメータを指定します。
対象
ODBC
構文
RPCRebind = value
パラメータ
value
説明
RPC パラメータが再バインドされるようにするかどうかを指
定します。以下のいずれかの値を指定します。
• 0 （デフォルト）バインドされた変数を使用して、必要な
バインド情報をすべて確認します。
• 1 パラメータを再バインドし、データベースから返された
パラメータ情報を使用してパラメータをバインドします。
デフォルト値
RPCRebind = 0
解説
RPC コールをサポートする DBMS の場合、 PowerBuilder はパラメータ
にバインドされている変数のサイズに基づいて、コール用のパラメー
タをバインドします。
ドライバのなかには、パラメータの再バインドを必要とするものもあ
ります。このため、パラメータサイズ（バックエンドデータベースか
ら返されたもの）が変数サイズのかわりに使用されます。この再バイ
ンドが失敗した場合は、エラーが発生したり文字列パラメータが切り
捨てられることがあります。ただし、バインドによる変数サイズの反
映が常に予期されるドライバもあります。 RPCRebind パラメータを使
うと、 RPC 実行時にパラメータが再バインドされるようにするかどう
かを指定できます。
接続リファレンス
155
ReturnCommandHandle
例
RPC パラメータが再バインドされるようにするかどうかを指定するに
は、以下の操作を行います。
DB プロファイル設定ダイアログボッ
クスの［トランザクション］タブの［RPC 再バインド］チェック
ボックスをオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "RPCRebind=1"
ReturnCommandHandle
機能
DBHandle 関数を呼び出したときに、 PowerBuilder からセッションオブ
ジェクトまたはデータソースオブジェクトへのハンドルを取得する
かどうかを指定します。
対象
OLE DB
構文
ReturnCommandHandle = value
パラメータ
value
説明
PowerBuilder からセッションオブジェクトまたはデータ
ソースオブジェクトへのハンドルを取得するかどうかを指
定します。以下のいずれかの値を指定します。
• 0 （デフォルト）データソースオブジェクトポインタを
返します。
• 1 セッションオブジェクトポインタを返します。
デフォルト値
ReturnCommandHandle = 0
解説
DBHandle は、パラメータとしてトランザクションオブジェクトを取
り、データソースオブジェクトまたはセッションオブジェクトへの
インタフェースポイントである Long 型の変数を返します。デフォル
トでは、 OLE DB インタフェースはデータソースオブジェクトのハン
ドルを返します。ReturnCommandHandle が 1 に設定されている場合は、
OLE DB インタフェースはセッションオブジェクトのハンドルを返し
ます。このハンドルは外部プログラムに渡し、インスタンスを作成し
て、 Microsoft DTC （Distributed Transaction Coordinator）トランザクショ
ンで接続を取得するために使用できます。
例
156
この例については、オンラインヘルプの「DBHandle:OLE DB example
の例」を参照してください。
PowerBuilder
第1章
データベースパラメータの解説
Scroll
機能
PowerBuilder から Informix データベースに接続するときに、スクロー
ルカーソルを使用することを指定するには以下のようにします。
Informix テーブルから行をフェッチするときに、スクロールカーソル
を使用すると、次の行、前の行、先頭の行、最後の行をフェッチでき
ます。
デフォルトでは、 Informix データベースとの接続でスクロールカーソ
ルを使用しません。
対象
IN9 Informix
構文
Scroll = value
パラメータ
value
説明
PowerBuilder から Informix データベースに接続するとき
に、スクロールカーソルを使用するかどうかを指定しま
す。以下のいずれかの値を指定します。
• 0 （デフォルト）スクロールカーソルを使用しません。
• 1 スクロールカーソルを使用します。
デフォルト値
Scroll = 0
例
PowerBuilder から Informix データベースに接続するときに、スクロー
ルカーソルを使用することを指定するには以下のようにします。
DB プロファイル設定ダイアログボッ
クスの［トランザクション］タブの［スクロールカーソルの使用］
チェックボックスをオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "Scroll=1"
接続リファレンス
157
Sec_Channel_Bind
Sec_Channel_Bind
機能
Sec_Channel_Bind は、 PowerBuilder から Open Client を経由して Sybase
Adaptive Server Enterprise データベースにアクセスするときの、ネット
ワークベースのセキュリティサービスのログイン認証をサポートす
るパラメータのうちの 1 つです。ほかのログイン認証パラメータにつ
いては、「関連項目」を参照してください。
Sec_Channel_Bind は、使用している接続のセキュリティメカニズムが
チャネルバインディングを実行するかどうかを制御します。
Sec_Channel_Bind が 1 に設定されている場合、Sybase Open Client ClientLibrary （CT-Lib）とサーバの両方が、接続の前にセキュリティメカニ
ズムに対してネットワークチャネル識別子を提供します。このチャネ
ル識別子には、クライアントおよびサーバのネットワークアドレスが
格納されています。
Sec_Channel_Bind が 0 （デフォルト）に設定されている場合、チャネ
ルバインディングは実行されません。
Sec_Channel_Bind パラメータは、データベースに接続する前に指定し
ます。
サードパーティのセキュリティメカニズムの使用
Sybase が Open Client セキュリティサービスでテスト済みのサード
パーティのセキュリティメカニズムおよびオペレーティングシステ
ムプラットフォームの詳細については、 Open Client のドキュメントを
参照してください。
対象
SYC Sybase Adaptive Server Enterprise
構文
Sec_Channel_Bind = value
パラメータ
value
デフォルト値
158
説明
使用している接続のセキュリティメカニズムがチャネル
バインディングを実行するかどうかを指定する値。以下の
いずれかの値を指定します。
• 0 （デフォルト）チャネルバインディングを実行しま
せん。また、 'No' または 'False' をこの値に指定する
こともできます。
• 1 チャネルバインディングを実行します。 CT-Lib と
サーバの両方が、接続のセキュリティメカニズムに対
してチャネル識別子を提供します。また、 'Yes' または
'True' をこの値に指定することもできます。
Sec_Channel_Bind = 0
PowerBuilder
第1章
解説
データベースパラメータの解説
CyberSafe Kerberos ではサポートされません使用しているセキュリ
ティメカニズムが CyberSafe Kerberos の場合、 Sec_Channel_Bind はサ
ポートされません。
Release パラメータの設定このパラメータを有効にするには、Release
パラメータに 11 以上を設定して、アプリケーションが適切なバージョ
ンの Sybase Open Client Client-Library （CT-Lib）の動作を使用すること
を指定する必要があります。詳細については、 Release パラメータの説
明を参照してください。
使用のための要件 Sec_Channel_Bind または、 Open Client をサポート
しているほかのパラメータを使用するには、 PowerBuilder アプリケー
ションでセキュリティサービスを使用するための一定の要件を満た
している必要があります。詳細については、『データベースとの接続』
マニュアルの「Open Client のセキュリティサービスを使用するための
条件」を参照してください。
対応する CT-Lib 接続プロパティ Sec_Channel_Bind に値を指定する
と、 CS_SEC_CHANBIND という名前の、対応する Sybase CT-Lib 接続
プロパティが設定されます。
例
使用している接続のセキュリティメカニズムがチャネルバインディ
ングを実行することを指定するには、以下のようにします。
DB プロファイル設定ダイアログボッ
クスの［セキュリティ］タブの［チャネルバインディング有効］
チェックボックスをオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "Sec_Channel_Bind=1"
関連項目
接続リファレンス
Release
Sec_Cred_Timeout
Sec_Delegation
Sec_Keytab_File
Sec_Mechanism
Sec_Mutual_Auth
Sec_Network_Auth
Sec_Server_Principal
Sec_Sess_Timeout
159
Sec_Confidential
Sec_Confidential
機能
Sec_Confidential は、 PowerBuilder から Open Client を経由して Sybase
Adaptive Server Enterprise データベースにアクセスするときの、ネット
ワークベースのセキュリティサービスのパケット単位のセキュリ
ティをサポートするパラメータのうちの 1 つです。ほかのパケット単
位のセキュリティパラメータについては、「関連項目」を参照してく
ださい。
Sec_Confidential は、転送データが暗号化されるかどうかを制御します。
Sec_Confidential が 1 に設定されている場合、サーバに送信されるすべ
てのリクエスト、およびサーバから返されたすべての結果が暗号化さ
れます。
Sec_Confidential が 0 （デフォルト）に設定されている場合、転送デー
タは暗号化されません。
Sec_Confidential パラメータは、 PowerBuilder からデータベースに接続
する前に指定します。
サードパーティのセキュリティメカニズムの使用
Sybase が Open Client セキュリティサービスでテスト済みのサード
パーティのセキュリティメカニズムおよびオペレーティングシステ
ムプラットフォームの詳細については、 Open Client のドキュメントを
参照してください。
対象
SYC Sybase Adaptive Server Enterprise
構文
Sec_Confidential = value
パラメータ
value
デフォルト値
160
説明
転送データが暗号化されるかどうかを指定する値。以下のい
ずれかの値を指定します。
• 0 （デフォルト）転送データを暗号化しません。また、'No'
または 'False' をこの値に指定することもできます。
• 1 転送データを暗号化します。サーバに送信されるリク
エストおよびサーバから返された結果は暗号化されます。
また、 'Yes' または 'True' をこの値に指定することもで
きます。
Sec_Confidential = 0
PowerBuilder
第1章
解説
データベースパラメータの解説
設定が必要な場合暗号化を行うと、パブリックネットワークを介し
て、セキュリティが設定されていないサーバへデータを送信する場合
に、自分のデータを保護できます。ネットワーク環境において、
Sec_Confidential を 1 に設定すれば、サーバに送信されるすべてのリク
エスト、およびサーバから返されたすべての結果が暗号化されること
が保証されます。
Release パラメータの設定このパラメータを有効にするには、Release
パラメータに 11 以上を設定して、アプリケーションが適切なバージョ
ンの Sybase Open Client Client-Library （CT-Lib）の動作を使用すること
を指定する必要があります。詳細については、 Release パラメータの説
明を参照してください。
使用のための要件 Sec_Confidential または、 Open Client セキュリティ
サービスをサポートしているほかのパラメータを使用するには、
PowerBuilder アプリケーションでセキュリティサービスを使用するた
めの一定の要件を満たしている必要があります。詳細については、
『データベースとの接続』マニュアルの「Open Client のセキュリティ
サービスを使用するための条件」を参照してください。
対応する CT-Lib 接続プロパティ Sec_Confidential に値を指定すると、
CS_SEC_CONFIDENTIALITY という名前の、対応する Sybase CT-Lib 接
続プロパティが設定されます。
例
転送データが暗号化されることを指定するには、以下のようにします。
DB プロファイル設定ダイアログボッ
クスの［セキュリティ］タブの［すべての結果を暗号化］チェッ
クボックスをオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "Sec_Confidential=1"
関連項目
接続リファレンス
Release
Sec_Data_Integrity
Sec_Data_Origin
Sec_Replay_Detection
Sec_Seq_Detection
161
Sec_Cred_Timeout
Sec_Cred_Timeout
機能
Sec_Cred_Timeout は、 PowerBuilder から Open Client を経由して Sybase
Adaptive Server Enterprise データベースにアクセスするときの、ネット
ワークベースのセキュリティサービスのログイン認証をサポートす
るパラメータのうちの 1 つです。ほかのログイン認証パラメータにつ
いては、「関連項目」を参照してください。
一部のセキュリティメカニズムでは、アプリケーションは、ネット
ワークベースのログイン認証を使用する接続に対する認証のタイム
アウト値を設定できます。Sec_Cred_Timeout では、ユーザのネットワー
ク認証の有効期限が切れ、無効になるまでの残りの秒数が指定されま
す。ユーザはネットワークにログインするときにネットワーク認証を
取得します。
デフォルトでは、 Sec_Cred_Timeout に認証のタイムアウトが指定され
ません。したがって、認証のタイムアウトは設定されません。
Sec_Cred_Timeout パラメータは、 PowerBuilder からデータベースに接
続する前に指定します。
サードパーティのセキュリティメカニズムの使用
Sybase が Open Client セキュリティサービスでテスト済みのサード
パーティのセキュリティメカニズムおよびオペレーティングシステ
ムプラットフォームの詳細については、 Open Client のドキュメントを
参照してください。
対象
SYC Sybase Adaptive Server Enterprise
構文
Sec_Cred_Timeout = value
パラメータ
value
説明
ユーザのネットワーク認証の有効期限が切れ、無効になる
までの残りの秒数を指定する値。 'no_limit' （デフォル
ト）を指定して、認証のタイムアウトが設定されないよう
にすることもできます。
セキュリティシステムの管理者によって設定された認証
タイムアウト値は、Sec_Cred_Timeout に優先して指定され
ます。
デフォルト値
Sec_Cred_Timeout = 'no_limit'
解説
CyberSafe Kerberos の場合使用しているセキュリティメカニズムが
CyberSafe Kerberos の場合、 Sec_Cred_Timeout は、インストール時のデ
フォルトの認証タイムアウト値を上書きできません。
162
PowerBuilder
第1章
データベースパラメータの解説
Release パラメータの設定このパラメータを有効にするには、Release
パラメータに 11 以上を設定して、アプリケーションが適切なバージョ
ンの Sybase Open Client Client-Library （CT-Lib）の動作を使用すること
を指定する必要があります。詳細については、 Release パラメータの説
明を参照してください。
使用のための要件 Sec_Cred_Timeout または、 Open Client セキュリ
ティサービスをサポートしているほかのパラメータを使用するには、
PowerBuilder アプリケーションでセキュリティサービスを使用するた
めの一定の要件を満たしている必要があります。詳細については、
『データベースとの接続』マニュアルを参照してください。
対応する CT-Lib 接続プロパティ Sec_Cred_Timeout に値を指定する
と、 CS_SEC_CREDTIMEOUT という名前の、対応する Sybase CT-Lib
接続プロパティが設定されます。
例
ユーザのネットワーク認証が 120 秒（2 分）後に期限切れになるよう
に指定するには、以下のようにします。
DB プロファイル設定ダイアログボッ
クスの［セキュリティ］タブの［アカウント情報タイムアウト］
ボックスで、 120 を入力します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "Sec_Cred_Timeout=120;Release=11"
関連項目
Release
Sec_Channel_Bind
Sec_Delegation
Sec_Keytab_File
Sec_Mechanism
Sec_Mutual_Auth
Sec_Network_Auth
Sec_Server_Principal
Sec_Sess_Timeout
Sec_Data_Integrity
機能
接続リファレンス
Sec_Data_Integrity は、 PowerBuilder から Open Client を経由して Sybase
Adaptive Server Enterprise データベースにアクセスするときの、ネット
ワークベースのセキュリティサービスのパケット単位のセキュリ
ティをサポートするパラメータのうちの 1 つです。ほかのパケット単
位のセキュリティパラメータについては、「関連項目」を参照してく
ださい。
163
Sec_Data_Integrity
Sec_Data_Integrity は、使用している接続のセキュリティメカニズムが、
サーバとの間で転送されるデータの整合性をチェックするかどうかを
制御します。 Sec_Data_Integrity が 1 に設定されている場合、セキュリ
ティメカニズムは、転送中に内容が変更されなかったことを確認する
ためにすべてのパケットを分析します。
Sec_Data_Integrity が 0 （デフォルト）に設定されている場合、整合性
のチェックは行われません。
Sec_Data_Integrity パラメータは、 PowerBuilder からデータベースに接
続する前に指定します。
サードパーティのセキュリティメカニズムの使用
Sybase が Open Client セキュリティサービスでテスト済みのサード
パーティのセキュリティメカニズムおよびオペレーティングシステ
ムプラットフォームの詳細については、 Open Client のドキュメントを
参照してください。
対象
SYC Sybase Adaptive Server Enterprise
構文
Sec_Data_Integrity = value
パラメータ
value
説明
使用している接続のセキュリティメカニズムが、サーバ
との間で転送されるデータに対して整合性のチェックを
行うかどうかを指定する値。以下のいずれかの値を指定し
ます。
• 0 （デフォルト）データの整合性のチェックを行いませ
ん。また、 'No' または 'False' をこの値に指定するこ
ともできます。
• 1 転送中に内容が変更されなかったことを確認するた
めにすべてのパケットを分析して、データの整合性を
チェックします。また、 'Yes' または 'True' をこの値
に指定することもできます。
デフォルト値
Sec_Data_Integrity = 0
解説
設定が必要な場合使用している接続のセキュリティメカニズムは、
ネットワークベースのログイン認証も使用しているときにのみ、データ
の整合性をチェックできます。詳細については、Sybase Open Client/Server
のマニュアルを参照してください。
164
PowerBuilder
第1章
データベースパラメータの解説
Release パラメータの設定このパラメータを有効にするには、Release
パラメータに 11 以上を設定して、アプリケーションが適切なバージョ
ンの Sybase Open Client Client-Library （CT-Lib）の動作を使用すること
を指定する必要があります。詳細については、 Release パラメータの説
明を参照してください。
使用のための要件 Sec_Data_Integrity または、 Open Client セキュリ
ティサービスをサポートしているほかのパラメータを使用するには、
PowerBuilder アプリケーションでセキュリティサービスを使用するた
めの一定の要件を満たしている必要があります。詳細については、
『データベースとの接続』マニュアルの「Open Client のセキュリティ
サービスを使用するための条件」を参照してください。
対応する CT-Lib 接続プロパティ Sec_Data_Integrity に値を指定する
と、 CS_SEC_INTEGRITY という名前の、対応する Sybase CT-Lib 接続
プロパティが設定されます。
例
使用している接続のセキュリティメカニズムがデータの整合性を
チェックすることを指定するには、以下のようにします。
DB プロファイル設定ダイアログボッ
クスで［セキュリティ］タブの［データ整合性の保証］チェック
ボックスをオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "Sec_Data_Integrity=1;Release=11"
関連項目
Release
Sec_Confidential
Sec_Data_Origin
Sec_Replay_Detection
Sec_Seq_Detection
Sec_Data_Origin
機能
接続リファレンス
Sec_Data_Origin は、 PowerBuilder から Open Client を経由して Sybase
Adaptive Server Enterprise データベースにアクセスするときの、ネット
ワークベースのセキュリティサービスのパケット単位のセキュリ
ティをサポートするパラメータのうちの 1 つです。ほかのパケット単
位のセキュリティパラメータについては、「関連項目」を参照してく
ださい。
165
Sec_Data_Origin
Sec_Data_Origin は、使用している接続のセキュリティメカニズムが
データの作成元のスタンプを記すかどうかを制御します。
Sec_Data_Origin が 1 に設定されている場合、セキュリティメカニズム
は各パケットに対し、パケットの作成元と内容を検証するデジタル署
名を付加します。
Sec_Data_Origin が 0 （デフォルト）に設定されている場合、データの
作成元のスタンプは記されません。
Sec_Data_Origin パラメータは、 PowerBuilder からデータベースに接続
する前に指定します。
サードパーティのセキュリティメカニズムの使用
Sybase が Open Client セキュリティサービスでテスト済みのサード
パーティのセキュリティメカニズムおよびオペレーティングシステ
ムプラットフォームの詳細については、 Open Client のドキュメントを
参照してください。
対象
SYC Sybase Adaptive Server Enterprise
構文
Sec_Data_Origin = value
パラメータ
value
説明
使用している接続のセキュリティメカニズムがデータの
作成元のスタンプを記すかどうかを指定する値。以下のい
ずれかの値を指定します。
• 0 （デフォルト）データ作成元のスタンプを記しませ
ん。また、 'No' または 'False' をこの値に指定するこ
ともできます。
• 1 各パケットに対し、パケットの作成元と内容を検証
するデジタル署名を付加することにより、データの作
成元のスタンプを記します。また、'Yes' または 'True'
をこの値に指定することもできます。
デフォルト値
Sec_Data_Origin = 0
解説
CyberSafe Kerberos ではサポートされません使用しているセキュリ
ティメカニズムが CyberSafe Kerberos の場合、 Sec_Data_Origin はサ
ポートされません。
Release パラメータの設定このパラメータを有効にするには、Release
パラメータに 11 以上を設定して、アプリケーションが適切なバージョ
ンの Sybase Open Client Client-Library （CT-Lib）の動作を使用すること
を指定する必要があります。詳細については、 Release パラメータの説
明を参照してください。
166
PowerBuilder
第1章
データベースパラメータの解説
使用のための要件 Sec_Data_Origin または、 Open Client セキュリティ
サービスをサポートしているほかのパラメータを使用するには、
PowerBuilder アプリケーションでセキュリティサービスを使用するた
めの一定の要件を満たしている必要があります。詳細については、
『データベースとの接続』マニュアルを参照してください。
対応する CT-Lib 接続プロパティ Sec_Data_Origin に値を指定すると、
CS_SEC_DATAORIGIN という名前の、対応する Sybase CT-Lib 接続プ
ロパティが設定されます。
例
使用している接続のセキュリティメカニズムがデータの作成元のス
タンプを記すことを指定するには、以下のようにします。
DB プロファイル設定ダイアログボッ
クスで［セキュリティ］タブの［パケットの起点を検証］チェッ
クボックスをオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "Sec_Data_Origin=1;Release=11"
関連項目
Release
Sec_Confidential
Sec_Data_Integrity
Sec_Replay_Detection
Sec_Seq_Detection
Sec_Delegation
機能
Sec_Delegation は、 PowerBuilder から Open Client を経由して Sybase
Adaptive Server Enterprise データベースにアクセスするときの、ネット
ワークベースのセキュリティサービスのログイン認証をサポートす
るパラメータのうちの 1 つです。ほかのログイン認証パラメータにつ
いては、「関連項目」を参照してください。
ネットワークベースのログイン認証を使用して Sybase Open Server
ゲートウェイに接続しているアプリケーションに対して、
Sec_Delegation は、ゲートウェイサーバが委任認証を使ってリモート
の SQL Server へ接続できるかどうかを制御します。 Sec_Delegation が
1 に設定されている場合、ゲートウェイはクライアントの委任認証を
使ってリモートサーバに接続できます。この場合、リモートサーバ
も、ネットワークベースの認証および同一のセキュリティメカニズム
を使用している必要があります。
接続リファレンス
167
Sec_Delegation
Sec_Delegation が 0 （デフォルト）に設定されている場合、ゲートウェ
イサーバは委任認証を使ってリモートサーバに接続できません。
Sec_Delegation パラメータは、 PowerBuilder からデータベースに接続す
る前に指定します。
サードパーティのセキュリティメカニズムの使用
Sybase が Open Client セキュリティサービスでテスト済みのサード
パーティのセキュリティメカニズムおよびオペレーティングシステ
ムプラットフォームの詳細については、 Open Client のドキュメントを
参照してください。
対象
SYC Sybase Adaptive Server Enterprise
構文
Sec_Delegation = value
パラメータ
value
説明
Sybase Open Server ゲートウェイがクライアントの委任認
証を使ってリモート SQL Server に接続できるかどうかを
指定する値。以下のいずれかの値を指定します。
• 0 （デフォルト）ゲートウェイは委任認証を使ってリ
モートサーバに接続できません。また、 'No' または
'False' をこの値に指定することもできます。
• 1 ゲートウェイは委任認証を使ってリモートサーバ
に接続できます。また、 'Yes' または 'True' をこの値
に指定することもできます。
デフォルト値
Sec_Delegation = 0
解説
CyberSafe Kerberos ではサポートされません使用しているセキュリ
ティメカニズムが CyberSafe Kerberos の場合、Sec_Delegation はサポー
トされません。
Release パラメータの設定このパラメータを有効にするには、Release
パラメータに 11 以上を設定して、アプリケーションが適切なバージョ
ンの Sybase Open Client Client-Library （CT-Lib）の動作を使用すること
を指定する必要があります。詳細については、 Release パラメータの説
明を参照してください。
使用のための要件 Sec_Delegation または、 Open Client セキュリティ
サービスをサポートしているほかのパラメータを使用するには、
PowerBuilder アプリケーションでセキュリティサービスを使用するた
めの一定の要件を満たしている必要があります。詳細については、
『データベースとの接続』マニュアルの「Open Client のセキュリティ
サービスを使用するための条件」を参照してください。
168
PowerBuilder
第1章
データベースパラメータの解説
対応する CT-Lib 接続プロパティ Sec_Delegation に値を指定すると、
CS_SEC_DELEGATION という名前の、対応する Sybase CT-Lib 接続プ
ロパティが設定されます。
例
Open Server ゲートウェイが委任認証を使ってリモートサーバに接続
できるようにするには、以下のようにします。
DB プロファイル設定ダイアログボッ
クスの［セキュリティ］タブの［委任されたアカウントの使用］
チェックボックスをオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "Sec_Delegation=1;Release=11"
関連項目
Release
Sec_Channel_Bind
Sec_Cred_Timeout
Sec_Keytab_File
Sec_Mechanism
Sec_Mutual_Auth
Sec_Network_Auth
Sec_Server_Principal
Sec_Sess_Timeout
Sec_Keytab_File
機能
Sec_Keytab_File は、 PowerBuilder から Open Client を経由して Sybase
Adaptive Server Enterprise データベースにアクセスするときの、ネット
ワークベースのセキュリティサービスのログイン認証をサポートす
るパラメータのうちの 1 つです。ほかのログイン認証パラメータにつ
いては、「関連項目」を参照してください。
Sec_Keytab_File は、セキュリティメカニズムとして Distributed Computing
Environment （DCE） Kerberos を使用している、ネットワークベースの
ログイン認証を要求する接続にのみ適用されます。このような接続の
場合に、 Sec_Keytab_File は DCE ユーザのセキュリティキーが格納さ
れているキータブファイルの名前を指定します。
データベースプロファイルまたはアプリケーションで指定されるロ
グイン ID が、現在アプリケーションを実行している DCE ユーザの
ユーザ名と異なる場合は、Sec_Keytab_File を設定する必要があります。
Sec_Keytab_File パラメータは、 PowerBuilder からデータベースに接続
する前に指定します。
接続リファレンス
169
Sec_Keytab_File
サードパーティのセキュリティメカニズムの使用
Sybase が Open Client セキュリティサービスでテスト済みのサード
パーティのセキュリティメカニズムおよびオペレーティングシステ
ムプラットフォームの詳細については、 Open Client のドキュメントを
参照してください。
対象
SYC Sybase Adaptive Server Enterprise
構文
Sec_Keytab_File = 'keytab_filename'
パラメータ
keytab_filename
デフォルト値
説明
DCE ユーザのセキュリティキーが格納されているキータ
ブファイルの名前
なし
値を指定しない場合、 Sec_Keytab_File または対応する Sybase Open
Client Client-Library （CT-Lib）接続パラメータの CS_SEC_KEYTAB は
設定されません。
解説
Distributed Computing Environment でのみサポートされますキータブ
ファイルの使用をサポートするのは、Distributed Computing Environment
（DCE）セキュリティサーバおよびクライアントだけです。したがっ
て、 Sec_Keytab_File は、使用しているセキュリティメカニズムが DCE
Kerberos であるときにのみサポートされます。
設定が必要な場合アプリケーションが、現在アプリケーションを実
行している DCE ユーザのユーザ名とは異なるユーザ名（ログイン ID）
を使ってサーバに接続できるようにしたい場合は、Sec_Keytab_File に、
該当するユーザのセキュリティキーが格納されているキータブファ
イルの名前を指定するように設定します。詳細については、『データ
ベースとの接続』マニュアルの「Open Client のセキュリティサービス
を使用するための条件」を参照してください。
Release パラメータの設定このパラメータを有効にするには、Release
パラメータに 11 以上を設定して、アプリケーションが適切なバージョ
ンの Sybase Open Client Client-Library （CT-Lib）の動作を使用すること
を指定する必要があります。詳細については、 Release パラメータの説
明を参照してください。
170
PowerBuilder
第1章
データベースパラメータの解説
使用のための要件 Sec_Keytab_File または、 Open Client セキュリティ
サービスをサポートしているほかのパラメータを使用するには、
PowerBuilder アプリケーションでセキュリティサービスを使用するた
めの一定の要件を満たしている必要があります。詳細については、
『データベースとの接続』マニュアルの「Open Client のセキュリティ
サービスを使用するための条件」を参照してください。
対応する CT-Lib 接続プロパティ Sec_Keytab_File に値を指定すると、
CS_SEC_KEYTAB という名前の、対応する Sybase CT-Lib 接続プロパ
ティが設定されます。
例
DCE キータブファイルの名前として C:\DCE_KEY を指定するには、
以下のようにします。
•
DB プロファイル設定ダイアログボッ
クスの［セキュリティ］タブの［Keytab ファイル］ボックスで、
以下の入力を行います。
データベースプロファイル
C:\DCE_KEY
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm =
"Sec_Keytab_File='C:\DCE_KEY';Release=11"
関連項目
Release
Sec_Channel_Bind
Sec_Cred_Timeout
Sec_Delegation
Sec_Mechanism
Sec_Mutual_Auth
Sec_Network_Auth
Sec_Server_Principal
Sec_Sess_Timeout
Sec_Mechanism
機能
接続リファレンス
Sec_Mechanism は、 PowerBuilder から Open Client を経由して Sybase
Adaptive Server Enterprise データベースにアクセスするときの、ネット
ワークベースのセキュリティサービスのログイン認証をサポートす
るパラメータのうちの 1 つです。ほかのログイン認証パラメータにつ
いては、「関連項目」を参照してください。
171
Sec_Mechanism
Open Client セキュリティサービスを使用するときには、要求されたド
ライバがロードできるように、 Open Client/Open Server Configuration
ユーティリティで、使用するセキュリティメカニズムの名前を指定す
る必要があります。デフォルトのセキュリティメカニズムは、
Configuration ユーティリティで現在アクティブに指定されているセ
キュリティメカニズムです。
Sec_Mechanism を使うと、デフォルトの（アクティブな）メカニズム
ではない、 Open Client/Open Server Configuration ユーティリティでリス
トされているセキュリティメカニズム名を指定できます。
Sec_Mechanism パラメータは、PowerBuilder からデータベースに接続す
る前に指定します。
サードパーティのセキュリティメカニズムの使用
Sybase が Open Client セキュリティサービスでテスト済みのサード
パーティのセキュリティメカニズムおよびオペレーティングシステ
ムプラットフォームの詳細については、 Open Client のドキュメントを
参照してください。
対象
SYC Sybase Adaptive Server Enterprise
構文
Sec_Mechanism = 'mechanism_name'
パラメータ
mechanism_name
説明
接続を確立するのに使用するセキュリティメカニズム名
セキュリティメカニズム名では大文字と小文字が区別さ
れます。 Open Client/Open Server Configuration ユーティリ
ティで表示されるとおりに指定する必要があります。
デフォルト値
Sec_Mechanism のデフォルト値は、Open Client/Open Server Configuration
ユーティリティで現在アクティブに指定されているセキュリティメ
カニズム名です。セキュリティメカニズム名が指定されていない場
合、接続を確立するのにセキュリティサービスは使用されません。
解説
設定が必要な場合 Sec_Mechanism は、デフォルトの（アクティブな）
セキュリティメカニズムではない、Open Client/Open Server Configuration
ユーティリティで指定されているセキュリティメカニズムを使用す
るときに設定します。 Open Client/Open Server Configuration ユーティリ
ティの使い方については、 Sybase Open Client/Server の『設定ガイド』
マニュアルを参照してください。
172
PowerBuilder
第1章
データベースパラメータの解説
Release パラメータの設定このパラメータを有効にするには、Release
パラメータに 11 以上を設定して、アプリケーションが適切なバージョ
ンの Sybase Open Client Client-Library （CT-Lib）の動作を使用すること
を指定する必要があります。詳細については、 Release パラメータの説
明を参照してください。
使用のための要件 Sec_Mechanism または、 Open Client セキュリティ
サービスをサポートしているほかのパラメータを使用するには、
PowerBuilder アプリケーションでセキュリティサービスを使用するた
めの一定の要件を満たしている必要があります。詳細については、
『データベースとの接続』マニュアルの「Open Client のセキュリティ
サービスを使用するための条件」を参照してください。
対応する CT-Lib 接続プロパティ Sec_Mechanism に値を指定すると、
CS_SEC_MECHANISM という名前の、対応する Sybase CT-Lib 接続プ
ロパティが設定されます。
例
セキュリティメカニズム名として KERBEROS を指定するには、以下
のようにします。
•
DB プロファイル設定ダイアログボッ
クスの［セキュリティ］タブの［セキュリティ方式］ボックスで、
以下の入力を行います。
データベースプロファイル
KERBEROS
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm =
"Sec_Mechanism='KERBEROS';Release=11"
関連項目
接続リファレンス
Release
Sec_Channel_Bind
Sec_Cred_Timeout
Sec_Delegation
Sec_Keytab_File
Sec_Mutual_Auth
Sec_Network_Auth
Sec_Server_Principal
Sec_Sess_Timeout
173
Sec_Mutual_Auth
Sec_Mutual_Auth
機能
Sec_Mutual_Auth は、 PowerBuilder から Open Client を経由して Sybase
Adaptive Server Enterprise データベースにアクセスするときの、ネット
ワークベースのセキュリティサービスのログイン認証をサポートす
るパラメータのうちの 1 つです。ほかのログイン認証パラメータにつ
いては、「関連項目」を参照してください。
Sec_Mutual_Auth は、使用している接続のセキュリティメカニズムが
相互認証を実行するかどうかを制御します。Sec_Mutual_Auth が 1 に設
定されている場合、サーバは、接続の前にサーバのプリンシパル名と
その名前が認証されていることの証明が格納された認証トークンを送
信することによってクライアントに対して身元を証明する必要があり
ます。
Sec_Mutual_Auth が 0 （デフォルト）に設定されている場合、相互認証
は実行されません。
Sec_Mutual_Auth パラメータは、 PowerBuilder からデータベースに接続
する前に指定します。
サードパーティのセキュリティメカニズムの使用
Sybase が Open Client セキュリティサービスでテスト済みのサード
パーティのセキュリティメカニズムおよびオペレーティングシステ
ムプラットフォームの詳細については、 Open Client のドキュメントを
参照してください。
対象
SYC Sybase Adaptive Server Enterprise
構文
Sec_Mutual_Auth = value
パラメータ
value
デフォルト値
174
説明
使用している接続のセキュリティメカニズムが相互認証
を実行するかどうかを指定する値。以下のいずれかの値を
指定します。
• 0 （デフォルト）相互認証を実行しません。また、 'No'
または 'False' をこの値に指定することもできます。
• 1 相互認証を実行します。サーバは、接続の前にサー
バのプリンシパル名とその名前が認証されていること
の証明が格納された認証トークンを送信することに
よってクライアントに対して身元を証明する必要があ
ります。また、 'Yes' または 'True' をこの値に指定す
ることもできます。
Sec_Mutual_Auth = 0
PowerBuilder
第1章
解説
データベースパラメータの解説
Release パラメータの設定このパラメータを有効にするには、Release
パラメータに 11 以上を設定して、アプリケーションが適切なバージョ
ンの Sybase Open Client Client-Library （CT-Lib）の動作を使用すること
を指定する必要があります。詳細については、 Release パラメータの説
明を参照してください。
使用のための要件 Sec_Mutual_Auth または、Open Client セキュリティ
サービスをサポートしているほかのパラメータを使用するには、
PowerBuilder アプリケーションでセキュリティサービスを使用するた
めの一定の要件を満たしている必要があります。詳細については、
『データベースとの接続』マニュアルの「Open Client のセキュリティ
サービスを使用するための条件」を参照してください。
対応する CT-Lib 接続プロパティ Sec_Mutual_Auth に値を指定する
と、 CS_SEC_MUTUALAUTH という名前の、対応する Sybase CT-Lib
接続プロパティが設定されます。
例
使用している接続のセキュリティメカニズムが相互認証を実行する
ことを指定するには、以下のようにします。
DB プロファイル設定ダイアログボッ
クスの［セキュリティ］タブの［相互認証］チェックボックスを
オンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "Sec_Mutual_Auth=1;Release=11"
関連項目
Release
Sec_Channel_Bind
Sec_Cred_Timeout
Sec_Delegation
Sec_Keytab_File
Sec_Mechanism
Sec_Network_Auth
Sec_Server_Principal
Sec_Sess_Timeout
Sec_Network_Auth
機能
接続リファレンス
Sec_Network_Auth は、PowerBuilder から Open Client を経由して Sybase
Adaptive Server Enterprise データベースにアクセスするときの、ネット
ワークベースのセキュリティサービスのログイン認証をサポートす
るパラメータのうちの 1 つです。ほかのログイン認証パラメータにつ
いては、「関連項目」を参照してください。
175
Sec_Network_Auth
Sec_Network_Auth は、使用している接続がネットワークベースのログ
イン認証を使用するかどうかを制御します。 Sec_Network_Auth が 1 に
設定されている場合、セキュリティが設定された SQL Server に接続す
るときに、使用している接続はネットワークベースのログイン認証を
使用します。ネットワークベースの認証とは、指定したユーザ名がア
プリケーションを実行している認証されたユーザであることを、アプ
リケーションではなくセキュリティメカニズムが確認することを意
味します。
アプリケーションではなく、セキュリティメカニズムがユーザ名（ロ
グイン ID）を認証するので、 Sec_Network_Auth が 1 に設定されている
場合は、データベースプロファイルまたはアプリケーションで、認証
のためにログインパスワードを入力する必要はありません。
Sec_Network_Auth が 0 （デフォルト）に設定されている場合、使用し
ている接続は、サーバに接続するためにネットワークベースのログイ
ン認証を使用しません。Sec_Network_Auth パラメータは、PowerBuilder
からデータベースに接続する前に指定します。
サードパーティのセキュリティメカニズムの使用
Sybase が Open Client セキュリティサービスでテスト済みのサード
パーティのセキュリティメカニズムおよびオペレーティングシステ
ムプラットフォームの詳細については、 Open Client のドキュメントを
参照してください。
対象
SYC Sybase Adaptive Server Enterprise
構文
Sec_Network_Auth = value
パラメータ
value
176
説明
セキュリティが設定された SQL Server に接続するときに、
使用している接続がネットワークベースのログイン認証を
使用するかどうかを指定する値。以下のいずれかの値を指
定します。
• 0 （デフォルト）サーバへ接続するときにネットワーク
ベースのログイン認証を使用しません。また、 'No' また
は 'False' をこの値に指定することもできます。
• 1 サーバへ接続するときにネットワークベースのログ
イン認証を使用します。アプリケーションではなく、セ
キュリティメカニズムがユーザ名（ログイン ID）を認証
するので、データベースプロファイルまたはアプリケー
ションで、認証のためにログインパスワードを入力する
必要はありません。また、 'Yes' または 'True' をこの値
に指定することもできます。
PowerBuilder
第1章
データベースパラメータの解説
デフォルト値
Sec_Network_Auth = 0
解説
設定が必要な場合 Sec_Network_Auth を 1 に設定して、ネットワーク
ベースのログイン認証を有効にすることには、以下に示すように、
PowerBuilder ユーザにとって 3 つの大きな利点があります。これらの
利点はすべて、 Sec_Network_Auth が 1 に設定されているときには、ロ
グイン ID を認証するために、データベースプロファイルまたはアプ
リケーションでログインパスワードを入力しないで済むことからくる
ものです。
ログインパス
ワードを指定しないので、ログインパスワードは Windows レジス
トリに格納されません。
•
パスワードがレジストリファイルに格納されません
•
ログインパスワード
を指定しないので、ログインパスワードがネットワークを介して
Adaptive Server に転送されることはありません。
•
さまざま
な Adaptive Server データベースサーバに接続するのに、同じネッ
トワークユーザ ID およびパスワードを使用できます。ネットワー
クセキュリティメカニズムに合わせてパスワードを変更し、その
変更内容を、アプリケーションが接続するすべてのサーバに適用
できます。
パスワードがネットワーク上で転送されません
異なるサーバで同じユーザ ID とパスワードを使用できます
Release パラメータの設定このパラメータを有効にするには、Release
パラメータに 11 以上を設定して、アプリケーションが適切なバージョ
ンの Sybase Open Client Client-Library （CT-Lib）の動作を使用すること
を指定する必要があります。詳細については、 Release パラメータの説
明を参照してください。
使用のための要件 Sec_Network_Auth または、 Open Client セキュリ
ティサービスをサポートしているほかのパラメータを使用するには、
PowerBuilder アプリケーションでセキュリティサービスを使用するた
めの一定の要件を満たしている必要があります。詳細については、
『データベースとの接続』マニュアルの「Open Client のセキュリティ
サービスを使用するための条件」を参照してください。
対応する CT-Lib 接続プロパティ Sec_Network_Auth に値を指定する
と、 CS_SEC_NETWORKAUTH という名前の、対応する Sybase CT-Lib
接続プロパティが設定されます。
例
接続リファレンス
サーバに接続するときに、使用している接続がネットワークベースの
ログイン認証を使用することを指定するには、以下のようにします。
177
Sec_Replay_Detection
DB プロファイル設定ダイアログボッ
クスの［セキュリティ］タブの［ネットワークベース認証］チェッ
クボックスをオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "Sec_Network_Auth=1;Release=11"
関連項目
Release
Sec_Channel_Bind
Sec_Cred_Timeout
Sec_Delegation
Sec_Keytab_File
Sec_Mechanism
Sec_Mutual_Auth
Sec_Server_Principal
Sec_Sess_Timeout
Sec_Replay_Detection
機能
Sec_Replay_Detection は、 PowerBuilder から Open Client を経由して
Sybase Adaptive Server Enterprise データベースにアクセスするときの、
ネットワークベースのセキュリティサービスのパケット単位のセ
キュリティをサポートするパラメータのうちの 1 つです。ほかのパ
ケット単位のセキュリティパラメータについては、「関連項目」を参
照してください。
Sec_Replay_Detection は、使用している接続のセキュリティメカニズム
が転送データに対する権限のないキャプチャおよびリプレイの試みを
検出し拒絶できるかどうかを指定する値。Sec_Replay_Detection が 1 に
設定されている場合、セキュリティメカニズムは、権限のない第 3 者
がサーバに送信されたパケットに対して行う、キャプチャおよびその
後のパケット内のコマンドの繰り返し（リプレイ）の試みを検出して
拒絶します。
Sec_Replay_Detection が 0 （デフォルト）に設定されている場合、セキュ
リティメカニズムは、データに対する権限のないキャプチャやリプレ
イの試みを検出できません。
Sec_Replay_Detection パラメータは、 PowerBuilder からデータベースに
接続する前に指定します。
178
PowerBuilder
第1章
データベースパラメータの解説
サードパーティのセキュリティメカニズムの使用
Sybase が Open Client セキュリティサービスでテスト済みのサード
パーティのセキュリティメカニズムおよびオペレーティングシステ
ムプラットフォームの詳細については、 Open Client のドキュメントを
参照してください。
対象
SYC Sybase Adaptive Server Enterprise
構文
Sec_Replay_Detection = value
パラメータ
value
説明
使用している接続のセキュリティメカニズムが転送デー
タに対する権限のないキャプチャおよびリプレイの試み
を検出し拒絶できるかどうかを指定する値。以下のいずれ
かの値を指定します。
• 0 （デフォルト）使用しているセキュリティメカニズ
ムは、転送データに対する権限のないキャプチャおよ
びリプレイの試みを検出できません。また、 'No' また
は 'False' をこの値に指定することもできます。
• 1 使用しているセキュリティメカニズムは、転送デー
タに対する権限のないキャプチャおよびリプレイの試
みを検出し拒絶できます。また、 'Yes' または 'True'
をこの値に指定することもできます。
デフォルト値
Sec_Replay_Detection = 0
解説
設定が必要な場合セキュリティが設定されていないネットワークで
は、権限のない第三者が、サーバに送信されたコマンドをキャプチャ
して、後日、そのコマンドを繰り返す（リプレイする）ことも起こり
得ます。たとえば、クライアントからサーバに P1、 P2、 P3 の順で送
信されたパケットを、サーバが P1、 P3、 P2 の順で受け取った場合は、
データのリプレイが試みられていると考えられます。
Sec_Replay_Detection を 1 に設定すると、そのような、ネットワーク上
で転送されるデータに対する権限のないキャプチャおよびリプレイの
試みがセキュリティメカニズムによって検出され、拒絶されることが
保証されます。
Release パラメータの設定このパラメータを有効にするには、Release
パラメータに 11 以上を設定して、アプリケーションが適切なバージョ
ンの Sybase Open Client Client-Library （CT-Lib）の動作を使用すること
を指定する必要があります。詳細については、 Release パラメータの説
明を参照してください。
接続リファレンス
179
Sec_Seq_Detection
使用のための要件 Sec_Replay_Detection または、Open Client セキュリ
ティサービスをサポートしているほかのパラメータを使用するには、
PowerBuilder アプリケーションでセキュリティサービスを使用するた
めの一定の要件を満たしている必要があります。詳細については、
『データベースとの接続』マニュアルの「Open Client のセキュリティ
サービスを使用するための条件」を参照してください。
対応する CT-Lib 接続プロパティ Sec_Replay_Detection に値を指定す
ると、 CS_SEC_DETECTREPLAY という名前の、対応する Sybase CTLib 接続プロパティが設定されます。
例
セキュリティメカニズムが、転送データに対する権限のないキャプ
チャおよびリプレイの試みを検出し、拒絶できるようにするには、以
下のようにします。
DB プロファイル設定ダイアログボッ
クスの［セキュリティ］タブの［再生されたコマンドの検出］チェッ
クボックスをオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm =
"Sec_Replay_Detection=1;Release=12.5"
関連項目
Release
Sec_Confidential
Sec_Data_Integrity
Sec_Data_Origin
Sec_Seq_Detection
Sec_Seq_Detection
機能
Sec_Seq_Detection は、 PowerBuilder から Open Client を経由して Sybase
Adaptive Server Enterprise データベースにアクセスするときの、ネット
ワークベースのセキュリティサービスのパケット単位のセキュリ
ティをサポートするパラメータのうちの 1 つです。ほかのパケット単
位のセキュリティパラメータについては、「関連項目」を参照してく
ださい。
Sec_Seq_Detection は、使用している接続のセキュリティメカニズム
が、クライアントから最初に送信されたのとは異なる順序でサーバに
届いた転送パケットを検出および拒絶できるかどうかを制御します。
Sec_Seq_Detection が 1 に設定されている場合、セキュリティメカニズ
ムは、誤った順序でサーバに届いたパケットを検出および拒絶します。
180
PowerBuilder
第1章
データベースパラメータの解説
Sec_Seq_Detection が 0 （デフォルト）に設定されている場合、セキュ
リティメカニズムは、誤った順序でサーバに届いたパケットを検出で
きません。
Sec_Seq_Detection パラメータは、 PowerBuilder からデータベースに接
続する前に指定します。
サードパーティのセキュリティメカニズムの使用
Sybase が Open Client セキュリティサービスでテスト済みのサード
パーティのセキュリティメカニズムおよびオペレーティングシステ
ムプラットフォームの詳細については、 Open Client のドキュメントを
参照してください。
対象
SYC Sybase Adaptive Server Enterprise
構文
Sec_Seq_Detection = value
パラメータ
value
説明
使用している接続のセキュリティメカニズムが、クライアン
トから最初に送信されたのとは異なる順序でサーバに届い
た転送パケットを検出および拒絶できるかどうかを指定す
る値。以下のいずれかの値を指定します。
• 0 （デフォルト）セキュリティメカニズムは、誤った順序
でサーバに届いたパケットを検出できません。また、 'No'
または 'False' をこの値に指定することもできます。
• 1 セキュリティメカニズムは、誤った順序でサーバに届
いたパケットを検出および拒絶できます。また、 'Yes' ま
たは 'True' をこの値に指定することもできます。
デフォルト値
Sec_Seq_Detection = 0
解説
設定が必要な場合ネットワーク上でデータを転送するとき、サーバ
に送信されたコマンドが誤った順序で届くことがあります。たとえば、
クライアントからサーバに P1、 P2、 P3 の順で送信されたパケットを、
サーバが P1、 P3、 P2 の順で受け取った場合、順序の誤りのエラーが
発生したと考えられます。
Sec_Seq_Detection を 1 に設定すると、誤った順序でサーバに届いたパ
ケットがセキュリティメカニズムにより検出および拒絶されること
が保証されます。
接続リファレンス
181
Sec_Server_Principal
Release パラメータの設定このパラメータを有効にするには、Release
パラメータに 11 以上を設定して、アプリケーションが適切なバージョ
ンの Sybase Open Client Client-Library （CT-Lib）の動作を使用すること
を指定する必要があります。詳細については、 Release パラメータの説
明を参照してください。
使用のための要件 Sec_Seq_Detection または、 Open Client セキュリ
ティサービスをサポートしているほかのパラメータを使用するには、
PowerBuilder アプリケーションでセキュリティサービスを使用するた
めの一定の要件を満たしている必要があります。詳細については、
『データベースとの接続』マニュアルの「Open Client のセキュリティ
サービスを使用するための条件」を参照してください。
対応する CT-Lib 接続プロパティ Sec_Seq_Detection に値を指定する
と、 CS_SEC_DETECTSEQ という名前の、対応する Sybase CT-Lib 接続
プロパティが設定されます。
例
セキュリティメカニズムが、誤った順序でサーバに届いたパケットを
検出および拒絶できるようにするには、以下のようにします。
DB プロファイル設定ダイアログボッ
クスの［セキュリティ］タブの［シーケンスエラーの検出］チェッ
クボックスをオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "Sec_Seq_Detection=1;Release=12.5"
関連項目
Release
Sec_Confidential
Sec_Data_Integrity
Sec_Data_Origin
Sec_Replay_Detection
Sec_Server_Principal
機能
Sec_Server_Principal は、 PowerBuilder から Open Client を経由して
Sybase Adaptive Server Enterprise データベースにアクセスするときの、
ネットワークベースのセキュリティサービスのログイン認証をサ
ポートするパラメータのうちの 1 つです。ほかのログイン認証パラ
メータについては、「関連項目」を参照してください。
Sec_Server_Principal は、アクセスするサーバのプリンシパル名を指定
します。サーバプリンシパル名は、セキュリティメカニズムがそれぞ
れのサーバを識別するのに使う名前です。
182
PowerBuilder
第1章
データベースパラメータの解説
サーバ名（データベースプロファイルまたはアプリケーションで指
定）が、アクセスするサーバのサーバプリンシパル名とは異なる場合、
接続するためには、 Sec_Server_Principal を適切なサーバプリンシパル
名に設定する必要があります。
Sec_Server_Principal パラメータは、 PowerBuilder からデータベースに
接続する前に指定します。
サードパーティのセキュリティメカニズムの使用
Sybase が Open Client セキュリティサービスでテスト済みのサード
パーティのセキュリティメカニズムおよびオペレーティングシステ
ムプラットフォームの詳細については、 Open Client のドキュメントを
参照してください。
対象
SYC Sybase Adaptive Server Enterprise
構文
Sec_Server_Principal = 'server_principal_name'
パラメータ
server_principal_name
デフォルト値
説明
アクセスするサーバプリンシパル名
なし
値を指定しない場合、セキュリティメカニズムは、サーバのディレク
トリエントリ名を使用します。これはデータベースプロファイルまた
はアプリケーションで指定されるサーバ名と同じです。
解説
設定が必要な場合 PowerBuilder で Open Client セキュリティメカニズ
ムを使用しているときは、サーバのディレクトリエントリ名（データ
ベースプロファイルまたはアプリケーションでサーバ名として指定
した名前）は、サーバプリンシパル名と異なることがあります。この
場合は、アクセスするサーバをセキュリティメカニズムが識別できる
ように、 Sec_Server_Principal を適切なサーバプリンシパル名に設定す
る必要があります。
Release パラメータの設定このパラメータを有効にするには、Release
パラメータに 11 以上を設定して、アプリケーションが適切なバージョ
ンの Sybase Open Client Client-Library （CT-Lib）の動作を使用すること
を指定する必要があります。詳細については、 Release パラメータの説
明を参照してください。
接続リファレンス
183
Sec_Sess_Timeout
使用のための要件 Sec_Server_Principal または、 Open Client セキュリ
ティサービスをサポートしているほかのパラメータを使用するには、
PowerBuilder アプリケーションでセキュリティサービスを使用するた
めの一定の要件を満たしている必要があります。詳細については、
『データベースとの接続』マニュアルの「Open Client のセキュリティ
サービスを使用するための条件」を参照してください。
対応する CT-Lib 接続プロパティ Sec_Server_Principal に値を指定す
ると、CS_SEC_SERVERPRINCIPAL という名前の、対応する Sybase CTLib 接続プロパティが設定されます。
例
アクセスするサーバのプリンシパル名として SYS12NT を指定するに
は、以下のようにします。
DB プロファイル設定ダイアログボッ
クスの［セキュリティ］タブの［サーバプリンシパル名］ボック
スに SYS12NT と入力します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm =
"Sec_Server_Principal='SYS12NT';Release=12"
関連項目
Release
Sec_Channel_Bind
Sec_Cred_Timeout
Sec_Delegation
Sec_Keytab_File
Sec_Mechanism
Sec_Mutual_Auth
Sec_Network_Auth
Sec_Sess_Timeout
Sec_Sess_Timeout
機能
Sec_Sess_Timeout は、 PowerBuilder から Open Client を経由して Sybase
Adaptive Server Enterprise データベースにアクセスするときの、ネット
ワークベースのセキュリティサービスのログイン認証をサポートす
るパラメータのうちの 1 つです。ほかのログイン認証パラメータにつ
いては、「関連項目」を参照してください。
184
PowerBuilder
第1章
データベースパラメータの解説
一部のセキュリティメカニズムでは、アプリケーションで、ネット
ワークベースのログイン認証を使った接続にセッションタイムアウ
ト値を設定できます。Sec_Sess_Timeout は、このような接続でセッショ
ンが期限切れになるまでの残りの秒数を指定します。セッションタイ
ムアウトは、接続がオープンされた時点からカウントが開始されます。
デフォルトでは、 Sec_Sess_Timeout にセッションタイムアウトが指定
されません。そのため、セッションのタイムアウトは設定されません。
Sec_Sess_Timeout パラメータは、PowerBuilder からデータベースに接続
する前に指定します。
サードパーティのセキュリティメカニズムの使用
Sybase が Open Client セキュリティサービスでテスト済みのサード
パーティのセキュリティメカニズムおよびオペレーティングシステ
ムプラットフォームの詳細については、 Open Client のドキュメントを
参照してください。
対象
SYC Sybase Adaptive Server Enterprise
構文
Sec_Sess_Timeout = value
パラメータ
value
説明
セッションが期限切れになるまでの残りの秒数。
'no_limit' （デフォルト）を指定して、セッションにタイ
ムアウトが設定されないようにすることもできます。
セキュリティシステムの管理者によって設定されたセッ
ションタイムアウト値は、 Sec_Sess_Timeout に優先して指
定されます。
デフォルト値
Sec_Sess_Timeout = 'no_limit'
解説
CyberSafe Kerberos の場合使用しているセキュリティメカニズムが
CyberSafe Kerberos の場合、 Sec_Sess_Timeout は、インストール時のデ
フォルトのセッションタイムアウト値を上書きできません。
Release パラメータの設定このパラメータを有効にするには、Release
パラメータに 11 以上を設定して、アプリケーションが適切なバージョ
ンの Sybase Open Client Client-Library （CT-Lib）の動作を使用すること
を指定する必要があります。詳細については、 Release パラメータの説
明を参照してください。
接続リファレンス
185
ServiceComponents
使用のための要件 Sec_Sess_Timeout または、 Open Client セキュリ
ティサービスをサポートしているほかのパラメータを使用するには、
PowerBuilder アプリケーションでセキュリティサービスを使用するた
めの一定の要件を満たしている必要があります。詳細については、
『データベースとの接続』マニュアルの「Open Client のセキュリティ
サービスを使用するための条件」を参照してください。
対応する CT-Lib 接続プロパティ Sec_Sess_Timeout に値を指定する
と、 CS_SEC_SESSTIMEOUT という名前の、対応する Sybase CT-Lib 接
続プロパティが設定されます。
例
セッションが 14,400 秒（4 時間）後にタイムアウトになるように指定
するには、次のようにします。
DB プロファイル設定ダイアログボッ
クスの［セキュリティ］タブの［セッションタイムアウト］ボッ
クスに 14400 と入力します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "Sec_Sess_Timeout=14400"
関連項目
Release
Sec_Channel_Bind
Sec_Cred_Timeout
Sec_Delegation
Sec_Keytab_File
Sec_Mechanism
Sec_Mutual_Auth
Sec_Network_Auth
Sec_Server_Principal
ServiceComponents
機能
OLE DB インタフェースが使用できるグローバルサービスを指定しま
す。
ServiceComponents を指定するタイミング
ServiceComponents パラメータは、データベースに接続する前に指定し
ます。
対象
OLE DB
構文
ServiceComponents = 'servicecomponent_name'
186
PowerBuilder
第1章
データベースパラメータの解説
デフォルト値
なし
例
リソースプーリングサービスコンポーネントを有効にするには以下
のようにします。
DB プロファイル設定ダイアログボッ
クスの［システム］タブの［サービスコンポーネントサポート］
ボックスから「リソースプーリング」を選択します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm =
"ServiceComponents='DBPROPVAL_OS_RESOURCEPOOLING'"
ShowTempTables
機能
データベースペインタまたは SQL Select ペインタでテーブルのリスト
を要求するときに、テンポラリテーブルを表示するかどうかを指定し
ます。
対象
SYC Sybase Adaptive Server Enterprise
構文
ShowTempTables = value
パラメータ
value
説明
テーブルのリストを要求するときに、テンポラリテーブル
を表示するかどうかを指定する値。以下のいずれかの値を
指定します。
• 1 （デフォルト）テンポラリテーブルを表示します。
• 0 テンポラリテーブルを表示しません。
デフォルト値
ShowTempTables = 1
解説
ShowTempTables データベースパラメータは、開発環境からデータベー
スに接続する場合のみ適用します。 ShowTempTables=1 のときに、ペイ
ンタからデータベーステーブルのリストを要求すると、 sp_pbnnntable
と sp_pbnnntemptab の両方の実行を引き起こします。これら 2 つの結果
集合を結合したものがユーザに表示されます。ShowTempTables=0 のと
きは、 sp_pbnnntable のみが実行されます。ストアドプロシージャ
（PBSYC.SQL）が ASE サーバにインストールされていない場合は、動
作は同じです。
例
テンポラリテーブルを表示するように指定するには、 DB プロファイ
ル設定ダイアログボックスの［システム］ページの［テンポラリテー
ブルを含める］チェックボックスを選択します。
接続リファレンス
187
SQLCache
SQLCache
機能
PowerBuilder がキャッシュする SQL 文の個数を指定します。デフォル
ト値は 0 で、 SQL キャッシュは空になります。
PowerBuilder では、以下を対象にしたキャッシュ処理が行われます。
対象
構文
•
データウィンドウオブジェクトやレポートが作成する SQL 文
•
埋め込み SQL 文
ODBC
SQLCache = value
パラメータ
value
説明
スクリプトで開くカーソルの個数に、データウィンドウに
よって作成される、検索引数を伴う SELECT 文の個数を加
えた数値。デフォルト値は 0 です。
デフォルト値
SQLCache = 0
解説
注意 SQLCache パラメータは、 Oracle 接続用の DB プロファイル設定
ダイアログボックスにあります。しかし、Oracle 8.x 以降の場合、Oracle
OCI を使用してキャッシュと SQLCache の設定を操作することは推奨
しません。
キャッシュの中でのステートメントの管理 SQL キャッシュの中のス
テートメントは、 LRU （least-recently-used）法で管理されています。つ
まり、キャッシュからステートメントを削除して、新たなステートメ
ント用の領域を確保する場合、最も古くに実行されたステートメント
が削除されます。
SQLCache とバインド変数頻繁に実行する SQL 文をキャッシュする
と、その SQL 文の処理速度が向上します。特に、バインド変数が使用
されている SQL 文は、アプリケーションの中で頻繁に使用されます。
なお、使用している DBMS でバインド変数がサポートされていない場
合は、 SQL 文をキャッシュする意味はあまりありません。
SQL 文をキャッシュする際の DisableBind の設定 SQL 文をキャッシュ
する際には、 DisableBind パラメータを 0 （デフォルト設定）に設定し
ます。この設定によって、 SQL 文に入力変数をバインドできるように
なります。
バインド変数については、 DisableBind を参照してください。
設定後の処理バインド変数を使用する SQL 文を最初に実行する際
に、 PowerBuilder によって以下の順序で処理が行われます。
188
PowerBuilder
第1章
データベースパラメータの解説
1
SQL 文を解析します。
2
SQL SELECT 文に対して適切なデータベース関数を呼び出し、結
果集合の情報を取得します。
3
バインド変数に対してメモリバッファを割り当てます。
4
割り当てられたメモリバッファを解析された SQL 文にバインド
します。
SQL 文をキャッシュすると、解析された SQL 文、結果集合の情報、メ
モリバッファの割り当てとバインド情報が、 SQL キャッシュに格納さ
れます。次回以降、この SQL 文を実行すると、 PowerBuilder がキャッ
シュからこの SQL 文を見つけるので、前述の処理を繰り返す必要があ
りません。
PowerBuilder によって SQL キャッシュ内で完全に合致する SQL 文が
検出された場合は、バインド変数にバインドされる新しい値が、あら
かじめ割り当てられたメモリバッファにコピーされ、 SQL 文が直ちに
実行されます。この方式は、 SQL 文のバインド変数を一から処理する
場合に比べて、格段に速い処理が期待できます。
SQL キャッシュのサイズの決定適切な SQL キャッシュのサイズを
決定するには、 Transaction オブジェクトの SqlReturnData プロパティの
値をチェックします。
データベースとの接続を解除すると、以下に示すように、 SQL キャッ
シュのヒットの数、ミスの数、エントリの数が、 SqlReturnData プロパ
ティに格納されます。
例
•
ヒット SQL キャッシュの中で、合致する SQL 文が検出された回
数です。
•
ミス SQL キャッシュの中で、合致する SQL 文を検出できなかっ
た回数です。
•
エントリ SQL キャッシュの中の SQL 文の総数です。この値は、
SQLCache パラメータの設定によって決定されます。
SQL 文を 25 個キャッシュできるだけの SQL キャッシュサイズを設定
するには以下のようにします。
DB プロファイル設定ダイアログボッ
クスの［トランザクション］タブの［キャッシュを行う SQL ス
テートメント数］ボックスに 25 と入力します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "SQLCache=25"
接続リファレンス
189
StaticBind
関連項目
DisableBind
StaticBind
機能
データベースからデータウィンドウオブジェクトまたはレポートに
データを取得するとき、 PowerBuilder では、データを取得する前に、結
果集合の情報を入手した上でデータベースに対して SELECT 文が有効
かどうか検証されません。この結果、特にネットワーク上のデータベー
スにアクセスするとき、データ取得がより高速になります（この機能
は describeless retrieval とも呼ばれます）。
デフォルト処理を変更し、 PowerBuilder でデータを取得する前に結果
集合の情報を入手するように設定するには、 StaticBind パラメータを 0
または No に設定します。
対象
ADO.NET
JDB JDBC
ODBC
OLE DB
O84 Oracle8i
O90 Oracle9i
O10 Oracle 10g
SYC および SYJ Sybase Adaptive Server Enterprise
構文
StaticBind = value
パラメータ
value
デフォルト値
190
説明
データベースからデータウィンドウオブジェクトまたはレ
ポートにデータを取得する前に、PowerBuilder が結果集合の
情報を入手するかどうかを指定する値。以下のいずれかの値
を指定します。
• 0 データを取得する前に結果集合の情報を入手します。
'No' と指定して、この値を設定することもできます。
• 1 （デフォルト）データを取得する前に、結果集合の情
報を入手しません。 'Yes' と指定して、この値を設定す
ることもできます。
StaticBind = 1
PowerBuilder
第1章
解説
データベースパラメータの解説
有効性の検証 StaticBind パラメータが 1 （デフォルト）に設定される
と、 PowerBuilder では、データを取得する前に、データベースに対し
て SELECT 文が有効であるかどうかを検証しません。この場合、結果
集合と、結果集合が取得されるデータウィンドウオブジェクトまたは
レポートのカラム書式が一致するものと見なされます。両者が一致し
ない場合は、エラーが表示されます。
トラブルシューティングのヒントデータウィンドウオブジェクト
またはレポートが入手する結果集合の情報と、現行のデータベースに
おける結果集合の情報が異なる場合、アプリケーションの中で問題が
発生する可能性があります。この状態は、以下の原因で発生します。
•
データウィンドウオブジェクトまたはレポートを作成した後で、
データベースの定義が変更された場合。
•
ある DBMS に接続している状態でデータウィンドウオブジェク
トまたはレポートを作成し、別の DBMS に対してこれを実行した
場合。
結果集合情報が矛盾するために発生する問題を解決するには、以下の
いずれかの方法でデータウィンドウオブジェクトまたはレポート定
義を訂正します。
•
カラム定義をエクスポートし、編集します。
•
データベースペインタの ISQL セッションビューの SQL 文を再コ
ンパイルします（詳しい手順については、『ユーザーズガイド』マ
ニュアルを参照してください）。
データウィンドウオブジェクトまたはレポートと DBMS 結果集合の
情報が一致しないときに、エラーが発生しないようにするには、
StaticBind パラメータを 0 または No に設定して、常に PowerBuilder が
データウィンドウオブジェクトまたはレポートにデータを取得する
前に結果集合情報を入手するようにします。
例
PowerBuilder が、データウィンドウオブジェクトまたはレポートに
データを取得する前に、結果集合の情報を入手することを指定するに
は以下のようにします。
•
•
DB プロファイル設定ダイアログボッ
クスの［トランザクション］タブ（OLE DB インタフェースの場合
［システム］タブ）で、［静的バインド］チェックボックスをオフ
にします。
データベースプロファイル
アプリケーション
コードにこの文を指定するには、以下の入力を
行います。
SQLCA.DBParm = "StaticBind=0"
接続リファレンス
191
StrByCharset
StrByCharset
機能
PowerBuilder （Unicode）と OCI クライアント（マルチバイト）間での
文字列変換が現行の OS コードページに基づくのか、 Oracle 文字セッ
トに基づくのかを指定します。
対象
O90 Oracle9i
O10 Oracle 10g
構文
StrByCharset='value'
パラメータ
value
説明
PowerBuilder と OCI クライアント間での文字列変換が現行
の OS コードページに基づくのか、 Oracle 文字セットに基
づくのかを指定します。以下のいずれかの値を指定します。
• 0 （デフォルト）文字列変換は、現行 OS コードページ
に基づきます。
• 1 文字列変換は、 NLS_Charset データベースパラメー
タで指定した Oracle 文字セットに基づきます。
デフォルト値
StrByCharset=0
解説
NLS_Charset に Unicode が設定してある場合、PowerBuilder と OCI クラ
イアントは UTF-16 形式を使用するため、StrByCharset データベースパ
ラメータは無視されます。NLS_Charset にほかの値を設定したとき、ク
ライアントの文字セットが OS コードページと非互換の場合は、
StrByCharset に 1 を設定する必要があります。
例 1 以下の設定を行った場合
StrByCharset=0
Oracle Server NLS_CHARACTER='WE8ISO8859P1'
PowerBuilder OCI client NLS_CHARSET='WE8ISO8859P1'
OS code page=1252
Oracle クライアントとサーバの文字セットは同じため、クライアント
からのすべての文字列データをサーバに送って、直接フェッチバック
することができます。いくつかの文字が WE8ISO8859P1 文字セットに
属さないが、コードページ 1252 の中にある場合でも、行うことができ
ます。これは、 Oracle クライアントとサーバ間で文字列変換を行われ
ないためです。すべての文字列データは、 OS コードページを使用し
て表示することが可能です。 StrByCharset に 1 を設定している場合、
OCI クライアント（ANSI）と PowerBuilder （Unicode）間で文字列を変
換するときに、 WE8ISO8859P1 文字セットにない文字は正しく変換さ
れません。
例 2 以下の設定を行った場合
192
PowerBuilder
第1章
データベースパラメータの解説
StrByCharset=0
Oracle Server NLS_CHARACTER='US7ASCII'
PowerBuilder OCI client NLS_CHARSET='US7ASCII'
OS code page=949 （韓国語）
クライアントとサーバの文字セットは同じです。韓国文字を含むすべ
ての文字データは、データを失わないようにするために、一度に 1 バ
イトずつ送受信されます。 StrByCharset に 0 を設定すると、韓国 OS
コードページを使用して、すべての韓国文字列データを ANSI から
Unicode へ問題なく変換することが可能です。
例3
以下の設定を行った場合
StrByCharset=1
Oracle Server NLS_CHARACTER='ZHT16BIG5'
PowerBuilder OCI client NLS_CHARSET='ZHT16BIG5'
OS code page=1252
ZHT16BIG5 文字セットの文字はコードページ 1252 に属さないため、
文字列のデータ変換は ZHT16BIG5 文字セットに基づきます。
例
OCI クライアントが、ローカルコンピュータの NLS_LANG パラメー
タで定義した現行の文字セットを使用して string データ型を格納する
ことを指定するためには、以下のようにします。
•
DB プロファイル設定ダイアログボッ
クスで、［NLS 文字セット］ドロップダウンリストから「Local」
を選択し、［システム］タブページにある［Oracle 文字セットに基
づいた文字コード変換を行う］ボックスを選択します。
•
アプリケーション
データベースプロファイル
コードに次のように入力します。
SQLCA.DBParm="NLS_Charset='Local',STRbyCharset=1"
関連項目
NLS_Charset
StripParmNames
機能
明示的に名前を付けられたパラメータを ODBC ドライバに渡すことを
許可しません。
対象
ODBC
構文
StripParmNames='value'
接続リファレンス
193
SvrFailover
パラメータ
value
説明
明示的に名前を付けられたパラメータを ODBC ドライバ
に渡すことを許可しません。以下のいずれかの値を指定し
ます。
• Yes 生成された CallEscape 構文からパラメータ名をす
べて削除します。
• No （デフォルト）生成された CallEscape 構文内に明示
的に指定されたパラメータ名が含まれる場合に、それを
維持します。
デフォルト値
StripParmNames='No'
解説
デフォルトでは、ストアドプロシージャの実行で明示的にパラメータ
名が指定された場合、 PowerBuilder はそのパラメータ名を維持します。
その結果、たとえば以下のような構文が生成され、 ODBC ドライバに
送られます。
{call proc(a=?,b=?)}
データベースベンダによっては、生成された CallEscape 構文内でパラメー
タ名を指定することを認めていません。明示的に名前を付けられたパラ
メータを ODBC ドライバに渡すことを禁止するには、 StripParmNames を
Yes に設定します。これは、パラメータが指定順に渡されることを意
味します。
例
ストアドプロシージャから明示的に指定されたパラメータ名を取り除
くには、以下のようにします。
DB プロファイル設定ダイアログボッ
クスの［構文］タブの［パラメータ名を取る］チェックボックス
をオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "StripParmNames='Yes'"
SvrFailover
機能
現行のデータベースサーバがダウンしたときに、フェイルオーバ内の
指定のバックアップデータベースサーバを PowerBuilder が認識して
それに参加することを指示します。
SvrFailover を指定するタイミング
SvrFailover パラメータは、データベースに接続する前に指定します。
194
PowerBuilder
第1章
データベースパラメータの解説
対象
O84 Oracle8i （8.1.5 以降のデータベース接続のみ）
O90 Oracle9i
O10 Oracle 10g
SYC Sybase Adaptive Server Enterprise （12.0 以降のデータベース接続の
み）
SYJ Sybase Adaptive Server Enterprise
構文
SvrFailover='value'
パラメータ
value
説明
現行のデータベースサーバがダウンしたときに、フェイ
ルオーバで指定のバックアップデータベースサーバを
PowerBuilder が認識してそれに参加することを指示しま
す。以下のいずれかの値を指定します。
• No （デフォルト） PowerBuilder がフェイルオーバを認
識または参加することを許可しません。
• Yes PowerBuilder がフェイルオーバを認識し、それに
参加します。
デフォルト値
SvrFailover = 'No'
解説
Oracle および Sybase は、Oracle バージョン 8.1.5 および Adaptive Server
12 以降でデータベースサーバのフェイルオーバをサポートします。こ
れらのデータベースサーバのフェイルオーバを構成する方法につい
ての詳細は、 Oracle または Adaptive Server のドキュメントを参照して
ください。フェイルオーバの発生時に、タイムアウトの結果
PowerBuilder データベース接続が喪失することを回避するために、
SvrFailover パラメータを設定することで、 PowerBuilder にデータベー
スサーバフェイルオーバを認識および参加させます。
Oracle では、フェイルオーバプロセスを一部管理できます。さらにほ
かの 3 つのパラメータを使用することで、接続するデータベースサー
バにおいてフェイルオーバを試みる回数、フェイルオーバを試みるま
での待機時間、 PowerBuilder でフェイルオーバの発生を示す実行時の
ダイアログボックスを表示するかどうかを指定できます。
このパラメータは、動的に設定することができません。接続の確立時
に設定された値は、接続が切断するまで有効です。
例
接続リファレンス
フェイルオーバを認識し、それに参加するように指示するには、以下
のようにします。
DB プロファイル設定ダイアログボッ
クスの［ネットワーク］タブの［サーバフェイルオーバを許可す
る］チェックボックスをオンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
195
SystemProcs
SQLCA.DBParm = "SvrFailover='Yes'"
関連項目
FoDelay
FoDialog
FoRetryCount
SystemProcs
機能
ストアドプロシージャのリストを要求したときに、接続しているデー
タベースにおける、システムストアドプロシージャとユーザ定義スト
アドプロシージャの両方を表示するかどうかを指定します。
デフォルトでは、接続しているデータベースにおける、システムスト
アドプロシージャとユーザ定義ストアドプロシージャの両方が表示
されます。 SystemProcs パラメータを 0 または No に設定すると、ユー
ザ定義ストアドプロシージャだけが表示されます。
対象
SYC Sybase Adaptive Server Enterprise
構文
SystemProcs = value
パラメータ
value
説明
ストアドプロシージャのリストを要求したときに、接続し
ているデータベースにおける、システムストアドプロシー
ジャとユーザ定義ストアドプロシージャの両方を表示する
かどうかを指定する値。以下のいずれかの値を指定します。
• 0 ユーザ定義ストアドプロシージャだけを表示します。
'No' と指定して、この値を設定することもできます。
• 1 （デフォルト）システムストアドプロシージャとユー
ザ定義ストアドプロシージャの両方を表示します。
'Yes' と指定して、この値を設定することもできます。
デフォルト値
SystemProcs = 1
解説
ユーザ定義ストアドプロシージャだけを操作したい場合は、SystemProcs
パラメータを 0 または No に設定すると、応答時間を短縮できます。
例
ストアドプロシージャのリストを要求したときに、接続しているデー
タベースにユーザ定義ストアドプロシージャだけを表示することを
指定するには以下のようにします。
•
196
DB プロファイル設定ダイアログボッ
クスの［システム］タブの［システムストアドプロシージャの表
示］チェックボックスをオフにします。
データベースプロファイル
PowerBuilder
第1章
•
アプリケーション
データベースパラメータの解説
コードにこの文を指定するには、以下の入力を
行います。
SQLCA.DBParm = "SystemProcs=0"
TableCriteria
機能
PowerBuilder の［使用できる DB インタフェース］リストに表示する
テーブルおよびビューのリストを制限する検索条件を指定します。
PowerBuilder 開発環境で非常に大規模なデータベースで作業をする場
合に、このパラメータはたいへん効果的です。
TableCriteria を指定するタイミング
TableCriteria パラメータは、データベースに接続する前に指定します。
TableCriteria パラメータは、 PowerBuilder アプリケーションのスクリプ
トでは無効です。
対象
JDB JDBC
ODBC
O84 Oracle8i
O90 Oracle9i
O10 Oracle 10g
SYC Sybase Adaptive Server Enterprise
構文
テーブルの抽出条件を、 DB プロファイル設定ダイアログボックスの
［システム］タブで指定します。
デフォルト値
なし。値を指定しない場合、TableCriteria パラメータは使用されません。
Oracle TableCriteria に値が指定されていない場合、アクセスできるす
べての Oracle テーブル、ビュー、およびシノニムがデフォルトで［使
用できる DB インタフェース］リストに表示されます。
解説
テーブルの抽出条件を指定するには、以下のボックスに情報を入力し
ます。
フィールド
テーブル名
説明
現行のデータベースで表示するテーブルの名前を指定
します。ワイルドカードを使用できます。
Adaptive Server Enterprise インタフェースのデフォルト
Adaptive Server Enterprise インタフェースを介して接続
する場合にこの値を省略すると、現行データベースのす
べてのテーブルが表示されます。
接続リファレンス
197
ThreadSafe
フィールド
テーブルオーナ
テーブルを含める
ビューを含める
システムテーブ
ルを含める
エリアスを含める
シノニムを含める
説明
指定されたテーブルオーナに属するテーブルだけが表
示されます。ワイルドカードを使用できます。
この値を省略すると、アクセスできるテーブル名と一致
するすべてのテーブルが表示されます。
テーブルが表示されるよう指定します。
ビューが表示されるよう指定します。
システムテーブルが表示されるよう指定します。
エリアステーブルが表示されるよう指定します。
シノニムテーブルが表示されるよう指定します。
Adaptive Server Enterprise Sybase データベースインタフェースは、ス
トアドプロシージャを使用してテーブルリストを作成します。
•
開発者またはデータ
ベース管理者によってインストールされた sp_pb100table ストアド
プロシージャを使用します。
Adaptive Server Enterprise インタフェース
Adaptive Server Enterprise データベースに接続する場合にどのバー
ジョンの sp_pb100table をインストールするかについては、『データ
ベースとの接続』マニュアルを参照してください。
PowerBuilder は、 TableCriteria パラメータを使用して、 sp_tables または
sp_pb100table に引数を渡し、検索基準に基づいてテーブルリストを作
成します。
例
DB プロファイル設定ダイアログボックスの［システム］タブの［テー
ブルオーナ］ボックスに DWMC31 を入力し、［テーブル名］ボックスに
QADB% を入力します。
TableCriteria='QADB%,DWMC31'
ThreadSafe
機能
接続でデータベースサーバのスレッドセーフクライアントライブラ
リを利用するかどうか指定します。
デフォルトでは、ThreadSafe は No に設定され、接続にはスレッドセー
フクライアントライブラリが使用されません。 ThreadSafe を Yes に設
定すると、接続にスレッドセーフクライアントライブラリが使用さ
れます。
198
PowerBuilder
第1章
データベースパラメータの解説
ThreadSafe を指定するタイミング
ThreadSafe パラメータは、データベースに接続する前に指定します。
対象
IN9 INFORMIX
O84 Oracle8i
O90 Oracle9i
O10 Oracle 10g
構文
ThreadSafe='value'
パラメータ
value
説明
接続でデータベースサーバのスレッドセーフクライアン
トライブラリを使用するかどうか指定します。以下のい
ずれかの値を指定します。
• Yes 接続にスレッドセーフクライアントライブラリ
が使用されます。この設定値は、マルチスレッド環境
を要求する分散アプリケーションを作成するときに使
います。
• No （デフォルト）接続にスレッドセーフクライアン
トライブラリが使用されません。この設定値は、単一
スレッド環境を要求する非分散アプリケーションを作
成するときに使います。
デフォルト値
ThreadSafe = 'No'
解説
設定が必要な場合 Oracle および Informix は、クライアントライブラ
リでスレッド保障のサポートを提供しています。 PowerBuilder で、
Oracle または Informix データベースインタフェースを使用して、マル
チスレッドアプリケーションを作成する場合は、 ThreadSafe パラメー
タを Yes に設定して、スレッドセーフクライアントライブラリを使
用する必要があります。これにより、データベースサーバに呼び出し
を行う複数の実行スレッドの間で発生する可能性がある悪影響を防ぐ
ことができます。ただし、スレッドセーフクライアントライブラリ
を使用する場合には、アプリケーションにより、パフォーマンス違反
が発生することもあることに注意してください。
デフォルトでは、クライアントソフトウェア（および PowerBuilder）
は、スレッドセーフクライアントライブラリを必要としない、単一
スレッド環境のアプリケーションの作成を前提としています。このデ
フォルト設定により、単一スレッドアプリケーションでは、スレッド
セーフクライアントライブラリの使用に関連するパフォーマンス違
反は起こらないことが保証されます。したがって、単一スレッドアプ
リケーションを作成する場合は、 ThreadSafe パラメータをそのまま No
（デフォルト）に設定しておいてかまいません。
接続リファレンス
199
Time
このパラメータは、動的に設定することができません。接続の確立時
に設定された値は、接続が切断するまで有効です。
例
使用している接続でスレッドセーフクライアントライブラリを使用
するように指定するには、以下のようにします。
DB プロファイル設定ダイアログボッ
クスで、［接続］タブの［スレッドセーフ］チェックボックスをオ
ンにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "ThreadSafe='Yes'"
Time
機能
データウィンドウペインタでデータを更新するときに、 PowerBuilder
はバックグランドで SQL UPDATE 文を作成します。 Time パラメータ
では、 SQL UPDATE 文で使用する Time データ型の書式が決定されま
す。
対象
JDB JDBC
ODBC
O84 Oracle8i
O90 Oracle9i
O10 Oracle 10g
構文
Time パラメータを指定する構文は、データベースによってわずかに異
なります。
DB プロファイル設定ダイアログボックスで、必要な場所に特殊文字
（引用符と円記号）が挿入されるので、指定するのは Time 型書式だけ
でかまいません。
コードでは、以下の構文を使用する必要があります。
JDBC / ODBC 構文 PowerBuilder 円記号とこれに続く 2 つの単引用符
（\''）は、 SQL UPDATE 文が作成されるときには 1 つの単引用符として
解析されます。
Time = ' \''time_format\'' '
Oracle 構文 PowerBuilder 連続する 4 つの単引用符（''''）は、 SQL
UPDATE 文が作成されるときには 1 つの単引用符として解析されま
す。
Time = ' ''''time_format'''' '
200
PowerBuilder
第1章
パラメータ
' \''
説明
JDBC / ODBC 構文単引用符、スペース、円記号、 2 つ
の単引用符の順に指定します。連続する 2 つの単引用符
と、 Time 型書式の間にスペースは入れません。
Oracle 構文単引用符、スペース、 4 つの単引用符の順
に指定します。連続する 4 つの単引用符と、Time 型書式
の間にスペースは入れません。
データウィンドウペインタにおいて、データソースを
更新するために SQL UPDATE 文を作成するときに、
PowerBuilder で使用される Time 型の書式
' ''''
time_format
表示書式については、『ユーザーズガイド』マニュアル
を参照してください。
JDBC / ODBC 構文円記号、 2 つの単引用符、スペース、
単引用符の順に指定します。Time 型書式と円記号の間に
スペースは入れません。
Oracle 構文 4 つの単引用符、スペース、単引用符の順
に指定します。 Time 型書式と、 4 つの連続する単引用符
の間にスペースは入れません。
\'' '
'''' '
デフォルト値
データベースパラメータの解説
Time のデフォルト値は、アクセスしている DBMS によって異なりま
す。
DBMS
JDBC
ODBC
Oracle
デフォルト値
Time パラメータに値が指定されていない場合、使用してい
る JDBC ドライバに対応するレジストリ内のセクションで
Time 型書式が検索されます。レジストリの中で Time 型書式
が見つからない場合は、JDBC の Time 型書式エスケープシー
ケンスが使用されます。
Time パラメータに値が指定されていない場合、PBODB100 初
期設定ファイルの ODBC ドライバに対応するセクションで
Time 型書式が検索されます。 PBODB100 初期設定ファイル
の中で Time 型書式が見つからない場合は、ODBC の Time 型
書式エスケープシーケンスが使用されます。
デフォルトの Oracle Time 型書式が使用されます。
詳細については、 Oracle のマニュアルを参照してください。
例
Start カラムを 08:30 に設定することにより、Workhours
という名前のテーブルを更新するものとします。この時刻は、以下の
PowerBuilder Time 型書式で表されます。
以下の例について
hh:mm
接続リファレンス
201
TimeFormat
例 1 （JDBC / ODBC 構文） SQL UPDATE 文を作成するときに、この
Time データ型書式を使用することを指定するには以下のようにしま
す。
•
DB プロファイル設定ダイアログボッ
クスの［構文］タブの［Time 型の書式］ボックスで、以下の入力
を行います。
データベースプロファイル
hh:mm
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "Time=' \''hh:mm\'' '"
作成される SQL UPDATE 文 PowerBuilder は、以下の SQL UPDATE 文
を作成してテーブルを更新します。
UPDATE WORKHOURS
SET START = '08:30'
例 2 （Oracle 構文） SQL UPDATE 文を作成するときに、この Time デー
タ型書式を使用することを指定するには以下のようにします。
•
DB プロファイル設定ダイアログボッ
クスの［構文］タブの［Time 型の書式］ボックスに hh:mm と入
力します。
•
アプリケーション
データベースプロファイル
コードに次のように入力します。
SQLCA.DBParm = "Time=' ''''hh:mm'''' '"
作成される SQL UPDATE 文 PowerBuilder は、以下の SQL UPDATE 文
を作成してテーブルを更新します。
UPDATE WORKHOURS
SET START = '08:30'
関連項目
Date
DateTime
TimeFormat
機能
データウィンドウペインタでデータを更新するときに、 PowerBuilder
はバックグランドで SQL UPDATE 文を作成します。 TimeFormat パラ
メータでは、 SQL UPDATE 文で使用する Time データ型の書式が決定
されます。
対象
ADO.NET
OLE DB
202
PowerBuilder
第1章
構文
データベースパラメータの解説
TimeFormat ='time_format'
パラメータ
time_format
説明
データウィンドウペインタにおいて、データソー
スを更新するために SQL UPDATE 文を作成すると
きに、 PowerBuilder で使用される Time 型の書式
表示書式については、『ユーザーズガイド』マニュ
アルを参照してください。
デフォルト値
TimeFormat パラメータに値が指定されていない場合、Time データ型は
使用されません。
解説
ストアドプロシージャを呼び出した場合、データベースサーバが
PowerBuilder が構築した Time 型書式を受け付けないことがあります。
この場合には、ほかの書式の使用を試みてください。例えば、Microsoft
SQL Server では、次の書式を試してみます。
TimeFormat='\''hh:mm:ss\'''
例
Start カラムを 08:30 に設定することにより、 Workhours という名前の
テーブルを更新するものとします。この時刻は、以下の PowerBuilder
Time 型書式で表されます。
hh:mm
SQL UPDATE 文を作成するときに、この Time データ型書式を使用す
ることを指定するには以下のようにします。
•
DB プロファイル設定ダイアログボッ
クスの［構文］タブの［Time 型の書式］ボックスで、以下の入力
を行います。
データベースプロファイル
hh:mm
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "TimeFormat='hh:mm'”
作成される SQL UPDATE 文 PowerBuilder は、以下の SQL UPDATE 文
を作成してテーブルを更新します。
UPDATE WORKHOURS
SET START = '08:30'
関連項目
接続リファレンス
DateFormat
DateTimeFormat
203
TimeOut
TimeOut
機能
データプロバイダとの接続が完了するのをインタフェースが待つ秒
数を指定します。
TimeOut を指定するタイミング
TimeOut の値は、データベースに接続する前に指定します。
対象
ADO.NET
OLE DB
構文
TimeOut = value
パラメータ
value
説明
接続が完了するのをインタフェースが待つ秒数
デフォルト値
なし
解説
TimeOut パラメータのデフォルト値はドライバによって異なります。
例
接続が完了するのを 10 秒待つように TimeOut 値を設定するには以下
のようにします。
DB プロファイル設定ダイアログボッ
クスの［システム］タブの［タイムアウト］ボックスに 10 と入力
します。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "TimeOut=10"
TimeStamp
機能
PowerBuilder が DateTime および Time データ型を Oracle TimeStamp
データ型にマッピングするかどうかを指定します。
対象
O90 Oracle9i
O10 Oracle 10g
構文
TimeStamp = value
204
PowerBuilder
第1章
パラメータ
value
データベースパラメータの解説
説明
PowerBuilder が DateTime および Time データ型を Oracle
TimeStamp データ型にマッピングするかどうかを指定する
値。以下のいずれかの値を指定します。
• 0 DateTime および Time データ型を Oracle Date データ
型にマッピングします。
• 1 （デフォルト） DateTime および Time データ型を
Oracle TimeStamp データ型にマッピングします。
デフォルト値
TimeStamp=1
解説
Oracle 9i 以降のデータベースと O90 および O10 インタフェースは
Oracle TimeStamp データ型をサポートしています。このデータ型には、
日付とミリ秒までの時刻が含まれます。既存の Oracle Date データ型に
はミリ秒情報は含まれません。データウィンドウオブジェクトでは、
Oracle TimeStamp データ型と Date データ型の両方が、ミリ秒情報をサ
ポートしている PowerBuilder DateTime データ型にマッピングされま
す。
O90 および O10 インタフェースを Oracle9i 以降のサーバと使用する場
合、 DateTime および Time データ型は、デフォルト動作では Oracle
TimeStamp データ型にマッピングされます。 DateTime および Time が
Oracle Date データ型にマッピングされるようにするには、 TimeStamp
データベースパラメータを 0 に設定します。
TimeStamp データベースパラメータは O84 データベースインタ
フェースには適用されません。O84 インタフェースを使用する場合は、
DateTime および Time データ型は常に Oracle Date データ型にマッピン
グされます。
PowerBuilder 8 以前では、 Oracle Date データ型で使用されるとき、ミリ
秒情報は切り捨てられました。 PowerBuilder 9.0 以降ではミリ秒情報は
切り捨てられません。その結果、 Date カラムにマッピングされる
DateTime フィールドを複数回更新すると、最初の更新は成功しますが、
以降の更新は「検索と更新の間に行が変更されました。」というエラー
を生成して失敗します。
TimeStamp データ型のみを使用するデータベースと一緒に O90 または
O10 インタフェースを使用する場合、データウィンドウ更新は正しく
処理されます。 Oracle Date データ型のみを使用するデータベースと一
緒に O90 または O10 インタフェースを使用する場合は、 DBParm
TimeStamp を 0 に設定すると、ミリ秒情報が切り捨てられます。
接続リファレンス
205
TraceFile
Date データ型と TimeStamp データ型の両方を使用するデータベースを
使用する場合は、どのカラムがどのデータ型を使用するかを確認し、
以下のようなコードを使用して、 Date カラムからミリ秒情報を取り除
く必要があります。
datetime dt
dt = datetime (date(string( today() ,"dd/mm/yyyy")),
time(string ( today() ,"hh:mm:ss ")))
dw_1.setitem(1,3,dt)
例
&
TimeStamp 値が DateTime および Time DataWindow データ型を Oracle
Date データ型として扱うように設定するには、以下の操作を行います。
•
DB プロファイル設定ダイアログボッ
クスの［構文］ページの［PB DateTime/Time 型を Oracle Timestamp
型にマップ］チェックボックスをオフにします。
•
アプリケーション
データベースプロファイル
コードに次のように入力します。
SQLCA.DBParm = "TimeStamp=0"
TraceFile
機能
PowerBuilder JDBC インタフェースを介してアクセスされるデータ
ベースへの接続を、 JDBC Driver Manager Trace ツールがトレースする
ように指定します。
対象
JDB JDBC
構文
TraceFile = 'tracefile_name'
デフォルト値
なし
解説
JDBC Driver Manager Trace は、PowerBuilder が JDBC インタフェースを
介してデータベースに接続する場合に、現在ロードされているドライ
バオブジェクト（Sybase jConnect JDBC ドライバなど）からのエラー
およびメッセージをログに記録します。この情報は、ログファイル
（デフォルトは JDBC.LOG）、または指定されたファイルに書き込まれ
ます。トレース出力の量は、使用されている JDBC ドライバによって
異なります。
トレースする接続のデータベースプロファイルを編集すれば、
PowerBuilder 開発環境で JDBC Driver Manager Trace を開始または停止
できます。また、適切なスクリプトで TraceFile パラメータを指定すれ
ば、 PowerBuilder アプリケーションで JDBC Driver Manager Trace を開
始および停止できます。
206
PowerBuilder
第1章
データベースパラメータの解説
JDBC Driver Manager Trace ツールの使い方については、『データベース
との接続』マニュアルを参照してください。
例
JDBC Driver Manager Trace を開始し、ログファイルを指定するには、
以下のようにします。
•
DB プロファイル設定ダイアログボッ
クスの［オプション］タブで、［JDBC コールをトレース］チェッ
クボックスをオンにし、［トレースファイル］ボックスで以下の入
力を行います。
データベースプロファイル
c:\temp\jdbctrce.log
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "TraceFile='c:\temp\jdbctrce.log'"
TrimSpaces
機能
次のデータ型から取り出されたデータ値から、後続スペースを削除す
るかどうかを指定します。 Char、 Char for Bit Data、 VarChar、および
VarChar for Bit Data。
対象
ADO.NET
IN9 Informix
JDB JDBC
ODBC
SYC および SYJ Sybase Adaptive Server Enterprise
構文
TrimSpaces = value
パラメータ
value
デフォルト値
接続リファレンス
説明
データ型 Char、Char for Bit Data、および VarChar for Bit Data
から後続スペースを削除するかどうかを指定します。以下
のいずれかの値を指定します。
• 0 後続スペースを削除しません。
• 1 （デフォルト）後続スペースを削除します。
TrimSpaces=0（ADO.NET および IN9）または TrimSpaces=1（SYC）。JDBC
の場合、デフォルト値はレジストリ内の PBTrimCharColumns の値で決
まります。 ODBC の場合、デフォルト値は PBODBnnn.INI ファイル内
の PBTrimCharColumns の値で決まります。（PBTrimCharColumns キー
ワードが特定のデータベース接続で不足している場合は、 ODBC のデ
フォルト値は TrimSpaces=0 になります。）
207
TrustedConnection
解説
デフォルトでは、次のデータ型からスペースが削除されます。 Char、
Char for Bit Data、 VarChar、および VarChar for Bit Data。
ODBC データベースインタフェース
ASA など一部の ODBC ドライバは、TrimSpaces が 0 に設定されていて
も、データがフェッチバッファに達する前に、後続の空白を削除しま
す。
WHERE 句の評価時に、後続スペース付きの CHAR データと後続ス
ペースなしの CHAR データを区別する DBMS を使用している場合、
データウィンドウの更新特性を " キーカラムおよび更新可能カラム "
に設定していると、「検索と更新の間に行が変更されました。」メッセージ
が表示されることがあります。このメッセージが表示されないように
するには、データウィンドウの更新特性を変更します。埋め込み SQL
の場合は、更新後に毎回 Sqlca.Sqlnrows をチェックすることにより、更
新が実際に実行されたかどうかを知ることができます。 TrimSpaces=1
の場合は、 UPDATE 文または DELETE 文の WHERE 句で、 CHAR 型の
データカラムを使用することを避けてください。
例
PowerBuilder で後続スペースを削除しないように指示するには、以下
のようにします。
DB プロファイル設定ダイアログボッ
クスの［構文］タブの［CHAR データ中の後続の空白を取る］チェッ
クボックスをオフにします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "TrimSpaces=0"
TrustedConnection
機能
現在の Windows アカウント資格情報が認証に使用されるかどうかを
指定します。
TrustedConnection を指定するタイミング
TrustedConnection パラメータは、データベースに接続する前に指定し
ます。
対象
ADO.NET
構文
TrustedConnection = value
208
PowerBuilder
第1章
パラメータ
value
データベースパラメータの解説
説明
現在の Windows アカウント資格情報が認証に使用されるか
どうかを指定する値。以下のいずれかの値を指定します。
• 0 （デフォルト）接続でユーザ ID とパスワードが指定さ
れます。
• 1 現在の Windows アカウント資格情報が認証に使用さ
れます。接続で指定されたユーザ ID とパスワードは無
視されます。
デフォルト値
TrustedConnection = 0
例
PowerBuilder で接続に信頼性を持たせるには、以下のようにします。
DB プロファイル設定ダイアログボッ
クスの［接続］タブの［信頼関係接続］チェックボックスをオン
にします。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "TrustedConnection=1"
URL
機能
JDBC インタフェースを使用して接続するデータベースの位置を指定
します。
URL を指定するタイミング
URL パラメータは、データベースに接続する前に指定する必要があり
ます。
対象
JDB JDBC
構文
URL = 'URL_address'
デフォルト値
なし
解説
データベースの URL は、データベースの JDBC ドライバのドキュメン
トから取得できます。登録済みの Driver クラスとそれらの URL のリス
トは、ドライバの JDBC DriverManager クラスで管理されます。接続が
リクエストされると、DriverManager はリストの中から適切なドライバ
を見つけます。
URL は、以下の一般書式を使用します。
jdbc:vendor:driverprotocol:servername:port/database
接続リファレンス
209
URL
引数
jdbc
vendor
driverprotocol
servername
port
database
説明
ドライバ
データベースのベンダ（Sybase または Oracle など）
データベースの通信プロトコル
DNS マシン名またはデータベースホスト名
データベースサーバにアクセスするための TCP/IP
ポート番号
（オプション）特定のデータベースの名前
データベースの URL には、以下のようにユーザ ID とパスワードを含
めることができます。
jdbc:vendor:driverprotocol:userid/password@servername:port:database
例
例 1 jConnect を介してアクセスされるデータベースの URL を設定す
るには、以下のようにします。
•
DB プロファイル設定ダイアログボッ
クスの［接続］タブの［URL］ボックスで以下の入力を行います。
データベースプロファイル
jdbc:sybase:Tds:199.93.178.151:5007/tsdata
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm =
"URL='jdbc:sybase:Tds:199.93.178.151:5007/tsdata'"
例 2 Oracle JDBC ドライバを介してアクセスされるデータベースの
URL を設定するには、以下のようにします。
•
DB プロファイル設定ダイアログボッ
クスの［接続］タブの［URL］ボックスで以下の入力を行います。
データベースプロファイル
jdbc:oracle:thin:@ora80nt:1521:orcl
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm =
"URL='jdbc:oracle:thin:@ora80nt:1521:orcl'"
例 3 Oracle JDBC ドライバを介してアクセスされるデータベースの、
ユーザ ID とパスワードを含む URL を設定するには以下のようにしま
す。
•
DB プロファイル設定ダイアログボッ
クスの［接続］タブの［URL］ボックスで以下の入力を行います。
データベースプロファイル
jdbc:oracle:thin:system/manager@ora80nt:1521:orcl
•
210
アプリケーション
コードに次のように入力します。
PowerBuilder
第1章
データベースパラメータの解説
SQLCA.DBParm =
"URL='jdbc:oracle:thin:system/manager@ora80nt:1521:
orcl'"
関連項目
Driver
UseContextObject
機能
PowerBuilder がトランザクションサービスコンテキストオブジェク
トの TransactionServer を使用してトランザクションを制御するように
指定します。このパラメータは、 PowerBuilder カスタムクラスユーザ
オブジェクトが EAServer コンポーネントまたは COM+ コンポーネン
トとして配布される場合だけ使用します。
対象
JDB JDBC
ODBC
O84 Oracle8i
O90 Oracle9i
SYJ Sybase Adaptive Server Enterprise
データベースインタフェースの制限
COM+ は ODBC、 Oracle O84、 Oracle O90 インタフェースをサポート
COM+ で Oracle Version 8.1.5 以降のデータベースに接続する場合、デー
タベーストランザクションがサポートされるのは、ODBC、Oracle O84、
および Oracle O90 インタフェースを経由する時です。
SYJ インタフェースを必要とする EAServer Sybase EAServer では、わず
かに異なるバージョンの CT-Lib ソフトウェアが使用されます。した
がって、実行時に、 Adaptive Server Enterprise データベースに接続する
には SYC ではなく SYJ データベースインタフェースを使用する必要
があります。 SYJ の DB プロファイル設定ダイアログボックスを使用
すると、適切な接続パラメータが設定され、構文を［プレビュー］タ
ブからトランザクションオブジェクトのスクリプトにコピーできま
す。
ただし、 PowerBuilder 開発環境からデータベースに接続する場合には
SYJ インタフェースを使用できません。したがって、開発段階では（コ
ンポーネントが EAServer に配布される前）、 SYC を使用してデータ
ベースに接続する必要があります。
構文
UseContextObject = 'value'
デフォルト値
UseContextObject = No
接続リファレンス
211
UseContextObject
解説
PowerBuilder には、 EAServer または COM+ が現行のトランザクション
をコミットするか、中止するかに影響を与えるトランザクション状態
プリミティブへのアクセスを提供する、TransactionServer というトラン
ザクションサービスコンテキストオブジェクトが用意されています。
UseConnectObject パラメータを Yes に設定して TransactionServer コン
テキストオブジェクトを使用する場合、COMMIT 文と ROLLBACK 文
が Transaction オブジェクトで呼び出されると実行時エラーになりま
す。
デフォルトでは、 TransactionServer コンテキストオブジェクトは使用
されません。代わりに、 COMMIT 文と ROLLBACK 文を使用してトラ
ンザクションを管理できます。この場合、 COMMIT は SetComplete 関
数として解釈され、 ROLLBACK は SetAbort 関数として解釈されます。
この方法は、 PowerBuilder 6.x 以前のオブジェクトを、コードを変更し
ないで EAServer または COM+ に移植する場合にだけ使用してくださ
い。
UseContextObject を Yes に設定した場合、 SetTrans 関数を使用すること
はできません。 SetTrans 関数は、データウィンドウエンジンでデータ
ベース接続、トランザクション状態プリミティブ、および関連する
EAServer コンポーネントの非活性化を管理する場合に使用します。
デフォルトの Web データウィンドウコンポーネントではデータベー
ス接続情報を指定するために SetTrans を使用するので、データベース
プロファイル内、またはコンポーネントの EAServer プロパティ内では
UseContextObject を Yes に設定しないでください。
PowerBuilder を使用して EAServer コンポーネントと COM+ コンポー
ネントを作成する方法については、『アプリケーションテクニック』マ
ニュアルを参照してください。
例
TransactionServer コンテキストオブジェクトを使用するには以下のよ
うにします。
DB プロファイル設定ダイアログボッ
クスの［EAServer］タブまたは［EAServer/COM+］タブの［トラ
ンザクションオブジェクトを使用］チェックボックスをオンにし
ます。
•
データベースプロファイル
•
アプリケーション
コードに次のように入力します。
SQLCA.DBParm = "UseContextObject = 'Yes'"
関連項目
212
CacheName
GetConnectionOption
ReleaseConnectionOption
PowerBuilder
第1章
データベースパラメータの解説
UTF8
機能
UTF8 データベースパラメータは、クライアントとサーバの文字セッ
トが異なっている場合に、アクセスしているデータベースサーバが文
字セットを変換するかどうかを指定します。
UTF8 を指定するタイミング
UTF8 パラメータは、PowerBuilder からデータベースに接続する前に指
定します。
対象
SYC および SYJ Sybase Adaptive Server Enterprise
構文
UTF8 = value
パラメータ
value
説明
アクセスしているデータベースサーバが、クライアントと
サーバで使用されている文字セット間での変換を実行する
かどうかを指定する値。以下のいずれかの値を指定します。
0 （デフォルト）PowerBuilder データベースインタフェース
は変換を実行します。複数の言語はサポートされません。
1 アクセスしているサーバが変換を実行します。複数の言
語がサポートされます。
デフォルト値
UTF8 = 0
解説
UTF8 に 1 を設定してある場合、 PowerBuilder は、 Adaptive Server デー
タベースに接続するとき、クライアントの文字セットとして常に UTF8 を使用します。 UTF8 が 0 に設定されている場合にクライアントと
データベースサーバの文字セットが異なっていると、データベースイ
ンタフェースは Transact-SQL、識別子、パラメータ、 Char データ、お
よび VarChar データを、サーバで使用されている文字セットとの間で
変換します。この設定では複数の言語はサポートされません。
複数言語のサポートを有効にするには、 UTF8 データベースパラメー
タを 1 に設定し、データベースサーバに UTF-8 文字セットをインス
トールする必要があります。 Adaptive Server では、 Unicode 変換をサ
ポートするように構成する必要があります。そのためには、データベー
ス管理者がサーバで以下のコマンドを実行します。
sp_configure "enable unicode conversion", 2
これによって、サーバが Unicode 変換を実行できるようになります。
例
接続リファレンス
PowerBuilder でアクセスしているデータベースサーバで、デフォルト
の文字セットとして UTF-8 が使用されるようにするには、以下の操作
を行います。
213
UTF8
•
DB プロファイル設定ダイアログボッ
クスの［地域の設定］タブの［UTF8 文字セットがインストール済
み、またはサーバで Unicode 変換が有効］チェックボックスをオ
ンにします。
•
アプリケーション
データベースプロファイル
コードに次のように入力します。
SQLCA.DBParm = "UTF8=1"
214
PowerBuilder
第 2 章
データベース環境設定項目
この章について
この章では、PowerBuilder において設定できる接続に関連したデー
タベース環境設定項目の、構文と使用方法について解説します。
内容
データベース環境設定項目は、アルファベット順に解説されてい
ます。
データベース環境設定項目とサポートされているデータ
ベースインタフェース
次の表に、サポートされているデータベースインタフェースと、
PowerBuilder でそのインタフェースと一緒に使用できる接続に関
連したデータベース環境設定項目を示します。表にリストされて
いる環境設定項目はデータベース接続に関するものであり、デー
タベースペインタの動作自体には関係ありません。
データベースインタフェース
ADO.NET
IN9 Informix
接続リファレンス
データベース環境設定項目
AutoCommit （自動コミットモード）
デフォルトのプロファイルに接続
DB の接続を保持
読み込みのみ
共有 DB プロファイル
SQL 構文の終止符
拡張属性の使用
AutoCommit （自動コミットモード）
デフォルトのプロファイルに接続
DB の接続を保持
LOCK （分離レベル）
読み込みのみ
共有 DB プロファイル
SQL 構文の終止符
拡張属性の使用
215
データベース環境設定項目とサポートされているデータベースインタフェース
データベースインタフェース
JDBC
ODBC
ODBC での AutoCommit と
Lock の使用
AutoCommit および Lock デー
タベース環境設定項目は、使用
している ODBC ドライバと
バックエンド DBMS の両方で
サポートされている場合にの
み ODBC インタフェースに
よってサポートされます。
OLE DB
O84 Oracle8i
O90 Oracle9i
O10 Oracle 10g
SYC Sybase Adaptive Server
Enterprise
216
データベース環境設定項目
AutoCommit （自動コミットモード）
デフォルトのプロファイルに接続
DB の接続を保持
LOCK （分離レベル）
読み込みのみ
共有 DB プロファイル
SQL 構文の終止符
拡張属性の使用
AutoCommit （自動コミットモード）
デフォルトのプロファイルに接続
DB の接続を保持
LOCK （分離レベル）
読み込みのみ
共有 DB プロファイル
SQL 構文の終止符
拡張属性の使用
AutoCommit （自動コミットモード）
デフォルトのプロファイルに接続
DB の接続を保持
読み込みのみ
共有 DB プロファイル
SQL 構文の終止符
拡張属性の使用
デフォルトのプロファイルに接続
DB の接続を保持
読み込みのみ
共有 DB プロファイル
SQL 構文の終止符
拡張属性の使用
AutoCommit （自動コミットモード）
デフォルトのプロファイルに接続
DB の接続を保持
LOCK （分離レベル）
読み込みのみ
共有 DB プロファイル
SQL 構文の終止符
拡張属性の使用
PowerBuilder
第2章
データベースインタフェース
SYJ Sybase Adaptive Server
Enterprise
データベース環境設定項目
データベース環境設定項目
AutoCommit （自動コミットモード）
デフォルトのプロファイルに接続
DB の接続を保持
LOCK （分離レベル）
読み込みのみ
共有 DB プロファイル
SQL 構文の終止符
拡張属性の使用
AutoCommit （自動コミットモード）
機能
PowerBuilder が SQL 文をトランザクションスコープの外側または内
側のどちらで発行するかを制御します。ただし、 DBMS およびデータ
ベースインタフェースが自動コミットをサポートする場合に限りま
す。
AutoCommit が False（デフォルト）に設定されている場合は、
PowerBuilder によって SQL 文がトランザクションスコープの内側で
発行されます。これに対して AutoCommit が True に設定されている場
合は、 SQL 文がトランザクションスコープの外側で発行されます。
AutoCommit を指定するタイミング
開発環境の場合、 AutoCommit は、データベースと接続する前に設定す
る必要があります。 AutoCommit は、データベースとの接続が発生した
ときに限って有効となります。接続した後で AutoCommit に変更を加
えても、現行の接続にはその変更が反映されません。
コードでは、 AutoCommit の値はいつでもリセットできます。このた
め、必要に応じて初期設定を変更できます。
対象
接続リファレンス
IN9 Informix
JDB JDBC
ODBC（ドライバおよびバックエンド DBMS がサポートしている場合）
OLE DB
SYC および SYJ Sybase Adaptive Server Enterprise
217
AutoCommit （自動コミットモード）
アプリケーションの場
合
自動コミットをサポートしている DBMS およびデータベースインタ
フェースの場合、トランザクションオブジェクトのプロパティとし
て、 AutoCommit をスクリプトの中で設定できます。以下の構文では、
デフォルトのトランザクションオブジェクト SQLCA を使用すること
が仮定されていますが、独自のトランザクションオブジェクトを定義
することもできます。
SQLCA.AutoCommit = value
パラメータ
value
開発環境の場合
説明
PowerBuilder が SQL 文をトランザクションスコープの外
側または内側のどちらで発行するかを指定する値。以下の
いずれかの値を指定します。
• True SQL 文は、トランザクションスコープの外側で発
行されます。つまり、ステートメントは、論理的な作業
単位（LUW）の一部ではありません。 SQL 文が正しい場
合、DBMS は COMMIT 文が発行されたかのように、デー
タベースを直ちに更新します。
• False （デフォルト） SQL 文は、トランザクションス
コープの内側で発行されます。 PowerBuilder は、接続を
開始するときに BEGIN TRANSACTION 文を発行しま
す。さらに、 COMMIT 文や ROLLBACK 文が発行される
たびに、別の BEGIN TRANSACTION 文を発行します。
DB プロファイル設定ダイアログボックスの［接続］タブで、［自動コ
ミットモード］チェックボックスをオンまたはオフにします。
•
チェックボックスをオンにする
この接続に対して、 AutoCommit を
True に設定します。
•
チェックボックスをオフにする（デフォルト）この接続に対して、
AutoCommit を False に設定します。
詳細については、『データベースとの接続』マニュアルの「接続パラ
メータの設定」を参照してください。
デフォルト値
AutoCommit = False
解説
トランザクショントランザクションとは、論理的な作業単位（LUW）
を形成する 1 つまたは複数の SQL 文です。トランザクションの中の
SQL 文はすべて、 1 つの論理的なエンティティとして処理され、正常
に終了するか、または異常終了します。トランザクションの中のすべ
ての SQL 文が正常に処理され、 COMMIT が発行された場合に限って、
データベースへの変更が行われます。 1 つでも SQL 文が失敗した場合
は、 ROLLBACK を発行して、変更を元に戻します。これによって、
データベースにおけるデータの整合性とセキュリティが保証されま
す。
218
PowerBuilder
第2章
データベース環境設定項目
SQL DDL 文の実行 DBMS によっては、特定の SQL 文をトランザク
ションスコープの外側で実行することが要求されます。たとえば、SQL
Server データベースに接続する場合、CREATE TABLE や DROP TABLE
などのデータ定義言語（DDL）文を、トランザクションの外側で実行
します。これには、以下に示す 2 つの理由があります。
•
データベースの構造が、トランザクションの最中に変更されない
ことを保証します。
•
DDL 文の復元の処理には時間がかかるため、データベースのパ
フォーマンスが向上します。
したがって、 SQL Server データベースにおいて、 DDL 文や、 DDL 文の
あるストアドプロシージャを実行するためには、 AutoCommit を True
に設定して、 DDL 文をトランザクションスコープの外側で発行しま
す。ただし、 DDL 文を実行したら、直ちに AutoCommit を False に戻
します。
AutoCommit の値を False から True に変更すると、 PowerBuilder で、デ
フォルトの COMMIT 文が発行されます。
警告
AutoCommit を True に設定すると、データベースの変更をロールバッ
クできなくなります。したがって、 AutoCommit の設定の変更には十分
に注意してください。
EXECUTE IMMEDIATE 文 AutoCommit が True に設定されている場合、
EXECUTE IMMEDIATE 動的 SQL 文を使用して、BEGIN TRANSACTION、
COMMIT TRANSACTION、ROLLBACK TRANSACTION などの SQL 文を
発行することによって、自身のトランザクション処理を制御できます。
EXECUTE IMMEDIATE 動的 SQL 文を使用して BEGIN TRANSACTION
を発行する場合は、 EXECUTE IMMEDIATE 動的 SQL 文を使用して、
対応する COMMIT TRANSACTION か ROLLBACK TRANSACTION を
発行する必要があります。
EXECUTE IMMEDIATE 文については『PowerScript リファレンス』マ
ニュアルを参照してください。
例
AutoCommit を True に設定し、トランザクションスコープの外側で
SQL 文を発行するように指定するには以下のようにします。
DB プロファイル設定ダイアログボックスの［接続］タ
ブで、［自動コミットモード］チェックボックスをオンにします。
•
開発環境
•
アプリケーション
スクリプトに次のように入力します。
SQLCA.AutoCommit = True
接続リファレンス
219
デフォルトのプロファイルに接続
データベースプロファイルで［自動コミットモー
ド］を指定すると、正しい構文が DB プロファイル設定ダイアログボッ
クスの［プレビュー］タブに表示されます。その構文を［プレビュー］
タブからコードにコピーできます。
コードでの例の使用
デフォルトのプロファイルに接続
機能
［デフォルトのプロファイルに接続］は、データベースペインタが起
動されたときに、それがデフォルトのプロファイルを使用してデータ
ベースとの接続を確立するかどうかを制御します。これが選択されて
いない場合、データベースとの接続を確立しないでデータベースペイ
ンタがオープンします。
対象
すべてのデータベースインタフェース
アプリケーションの場
合
［デフォルトのプロファイルに接続］環境設定は、コードでは設定でき
ません。
開発環境の場合
データベースペインタで、 DB 環境設定プロパティシートの［デフォ
ルトのプロファイルに接続］チェックボックスを、以下のようにオン
またはオフにします。
（デフォルト）データベースペイン
タを次に起動するときに、自動的にデフォルトのデータベースプ
ロファイルに接続されます。
•
チェックボックスをオンにする
•
チェックボックスをオフにするデータベースペインタを次に起動
するときに、デフォルトのデータベースプロファイルに自動的に
は接続されません。
デフォルト値
DB 環境設定プロパティシートの［デフォルトのプロファイルに接続］
チェックボックスは、デフォルトで選択されています。
解説
［デフォルトのプロファイルに接続］では、データベースとの接続を確
立しないでデータベースペインタをオープンできます。そのため、
データベースプロファイルの定義およびデータベースとの接続など
の、データベースに関連するすべてのタスクをデータベースペインタ
で実行できます。ただし、データベースペインタをオープンするとよ
り多くのシステムリソースが使用されるので、プロファイルの定義と
データベースとの接続はデータベースプロファイルを使用して行っ
た方がよいでしょう。
220
PowerBuilder
第2章
データベース環境設定項目
DB の接続を保持
機能
デフォルトでは、 PowerBuilder は接続に必要なペインタを最初にオー
プンする時に、データベース接続をオープンして、データベースを終
了するまでセッションしている間接続を保持します。
データベースプロファイルを使用しないで、 PowerBuilder 開発環境で
データベースに接続する場合は、データベース環境設定の［DB の接続
を保持］を設定して、 PowerBuilder がデータベース接続を終了する時
間を指定できます。
［DB の接続を保持］は、 PowerBuilder 開発環境でデータベースプロ
ファイルを使用しないでデータベース接続をする場合にのみ適用でき
ます。［DB の接続を保持］の設定は、 PowerBuilder でデータベースプ
ロファイルを使用して接続する場合には無効です。
対象
すべてのデータベースインタフェース（開発環境のみ）
アプリケーションの場
合
［DB の接続を保持］環境設定は、コードでは設定できません。
開発環境の場合
データベースペインタで、 DB 環境設定プロパティシートの［DB の
接続を保持］チェックボックスを、以下のようにオンまたはオフにし
ます。
（デフォルト）PowerBuilder セッショ
ンの間中データベースを接続させて、終了時に接続を解除します。
•
チェックボックスをオンにする
•
チェックボックスをオフにする
ペインタが必要な時にデータベー
ス接続をオープンして、ペインタの終了時かスクリプトをコンパ
イルする時に接続を解除します。
デフォルト値
DB 環境設定プロパティシートの［DB の接続を保持］チェックボック
スは、デフォルトでオンになります。
解説
［DB の接続を保持］の使用のための要件データベース環境設定の
［DB の接続を保持］を使用するには、以下の両方が True である必要が
あります。
接続リファレンス
開発環境で作業をする必要があります。
•
開発環境での作業
•
デフォルト接続情報の使用 PowerBuilder は、 Windows レジストリの
最近使った接続情報を使って、データベースに接続する必要があ
ります。［DB の接続を保持］は、データベースに接続するデータ
ベースプロファイルを選択した場合は無効です。
221
LOCK （分離レベル）
設定後の処理上記の要件を満たしている場合、［DB の接続を保持］
チェックボックスをオフにすると、接続に必要なペインタで作業をし
ている場合にのみ、データベース接続がオープンになり、それ以外の
場合は接続が解除されます。この設定を行っておけば、接続時間に応
じて料金がかかるデータベースへアクセスしている場合に、費用を節
約できます。
LOCK （分離レベル）
機能
値や分離レベルをサポートする DBMS およびデータベースインタ
フェースに対して、データベースと接続するときに、使用する分離レ
ベルを設定します。
マルチユーザデータベースでは、異なるユーザによって開始されたト
ランザクションがオーバーラップすることがあります。複数のトラン
ザクションがデータベース内の共用データにアクセスすると、お互い
に上書きしたり、衝突することがあります。
DBMS によっては、データベースとの接続時に分離レベルを設定でき
ます。これは、同時に実行されるトランザクションがお互いに干渉せ
ず、データベースの整合性を保つためです。分離レベル（Isolation Level、
排他レベルなどとも呼ばれます）は DBMS によって定義され、あるト
ランザクション内の処理が、ほかの同時実行トランザクションの処理
にどのような影響を及ぼすかを指定します。分離レベルによって
DBMS データにアクセスする間、ほかのプロセスからどのように分離
されるか、つまりデータに対してどのタイミングでロックをかけるか
が決定されます。
PowerBuilder では、 Lock 環境設定項目を使用して各種のデータベース
ロックオプションを設定できます。 Lock 値は、使用している DBMS
が定義する分離レベルによって異なります。
Lock 値を指定するタイミング
Lock 値は、データベースに接続する前に指定します。 Lock 値は、デー
タベースとの接続が発生したときに限って有効となります。接続後に
Lock 値に変更を加えても、現在の接続への影響はありません。
対象
IN9 Informix - OnLine データベース
JDB JDBC
ODBC（ドライバおよびバックエンド DBMS がサポートしている場合）
OLE DB
SYC および SYJ Sybase Adaptive Server Enterprise
222
PowerBuilder
第2章
アプリケーションの場
合
データベース環境設定項目
Lock をサポートしている DBMS およびデータベースインタフェース
の場合、トランザクションオブジェクトのプロパティとして、 Lock 値
をコードの中で設定できます。以下の構文では、デフォルトのトラン
ザクションオブジェクト SQLCA を使用することが仮定されています
が、ユーザ定義のトランザクションオブジェクトも使用できます。
SQLCA.Lock ='value'
value は、設定する Lock 値です。
Lock 値
次の表に、 Lock をサポートするデータベースインタフェースの Lock
値と対応する分離レベルを示します。 Lock 値はコードで、分離レベル
はデータベースプロファイルで設定します。
使用している DBMS がサポートする分離レベルについては、DBMS の
マニュアルを参照してください。
データベース
インタフェース
IN9 Informix
（OnLine データ
ベース専用）
JDB JDBC
ODBC
OLE DB
Lock 値
Dirty Read
分離レベル
Dirty Read
Committed Read
Committed Read
Cursor Stability
Cursor Stability
Repeatable Read
RU
Repeatable Read
Read Uncommitted
RC
Read Committed
RR
Repeatable Read
TS
Serializable Transactions
TN
RU
Transaction None
Read Uncommitted
RC
Read Committed
RR
Repeatable Read
TS
Serializable Transactions
TV
RU
Transaction Versioning
Read Uncommitted
RC
Read Committed
RR
Repeatable Read
TS
Serializable Transactions （デフォルト）
Chaos
Read Uncommitted
TC
Sybase Adaptive 0
Server Enterprise 1
3
接続リファレンス
Read Committed （デフォルト）
Serializable Transactions
223
LOCK （分離レベル）
開発環境の場合
DB プロファイル設定ダイアログボックスの［接続］タブで、［分離レ
ベル］ドロップダウンリストの分離レベルを選択します。
詳細については、『データベースとの接続』マニュアルの「接続パラ
メータの設定」を参照してください。
デフォルト値
デフォルトの Lock 値は、データベースの設定によって異なります。詳
細については、使用している DBMS のマニュアルを参照してくださ
い。
解説
ODBC TV （Transaction Versioning）設定は、 Adaptive Server Anywhere
データベースには適用されません。
OLE DB Microsoft 社が Microsoft SQL Server 2000 で DBLib インタ
フェースのサポートを終了したため、 PowerBuilder では Microsoft SQL
Server 用 MSS ネイティブドライバのサポートを終了しました。
Microsoft 社はかわりに OLE DB の利用を推奨しています。MSS インタ
フェースの Lock のデフォルト値は「Read Committed」でしたが、 OLE
DB のデフォルト値は「Serializable Transactions」です。 PBODB100.INI
ファイルで Lock の値を指定することで、デフォルト値を上書きできま
す。以下はその例です。
[Microsoft SQL Server]
...
LOCK='RC'
...
Sybase Adaptive Server Enterprise Sybase Adaptive Server Enterprise は、
SQL Server の分離レベルに対応して、以下の Lock 値をサポートしま
す。
•
0 - Read Uncommitted （ダーティ読み出し）分離レベル 0 は、コミッ
トしていないトランザクションが（UPDATE などの SQL 文で）変
更したデータを、別のトランザクションが変更することを禁止し
ます。
最初のトランザクションがコミットするまで、別のトランザク
ションがデータを変更できません。しかし、コミットしていない
データであっても、別のトランザクションがこれを読み込み、ダー
ティ読み出しを実行することはできます。分離レベル 0 は、テー
ブルやページ上での検索ロックを禁止します。
分離レベル 0 は、 Sybase System Version 10 以降のデータベースに
限って有効です。
•
1- Read Committed （デフォルト）分離レベル 1 は、テーブルや
ページ上での共有ロックを発行することによって、ダーティ読み
出しを禁止します。
224
PowerBuilder
第2章
データベース環境設定項目
ダーティ読み出しは、あるトランザクションがテーブルの行を変
更していて、その変更がコミットされる前に、 2 番目のトランザク
ションがその行を読み込むときに発生します。最初のトランザク
ションが変更をロールバックすると、2 番目のトランザクションが
読み込んだ情報は無効になります。
•
分離レベル 3 は、
トランザクションの間のダーティ読み出し、非繰り返し読み込み
やファントム値を禁止します。
3 - Serializable Transactions （HOLDLOCK 動作）
非繰り返し読み込みは、あるトランザクションが行を読み込み、続
けて 2 番目のトランザクションがその行を変更するときに発生し
ます。 2 番目のトランザクションが変更をコミットした後で、最初
のトランザクションがまた読み込むと、最初の読み込みと異なる
結果が得られます。
ファントム値は、あるトランザクションが検索条件を満たす行の
セットを読み込み、 2 番目のトランザクションが SQL INSERT、
UPDATE、または DELETE 文でそのデータを変更するときに発生
します。最初のトランザクションが同じ検索条件でまた読み込む
と、最初の読み込みと異なる行のセットが得られます。
分離レベルの動的制御 Sybase Adaptive Server Enterprise データベースに
接続している状態で、 PowerBuilder は 2 番目の接続をし、以下のいず
れかを実装します。
•
データウィンドウが、必要な行だけをデータベースから取得する
ように指定する Retrieve.AsNeeded プロパティ
•
指定されたテーブル行の中で 1
SELECTBLOB 埋め込み SQL 文
つの
blob
カラムを選択する
Adaptive Server Enterprise に最初に接続する前に設定したロック値は、2
番目の接続にも自動的に継承され、 2 番目の接続用に変更できません。
しかし、アプリケーションの中で、次の PowerScript 埋め込み SQL 文
を記述することによって、最初（オリジナル）の Adaptive Server
Enterprise 接続に対する分離レベルを、動的に制御できます。 n には、最
初の接続に対して設定する 0、1、または 3 の分離レベルを指定します。
EXECUTE IMMEDIATE "set transaction isolation level n"
たとえば、次の PowerScript 埋め込み SQL コードでは、 2 番目の接続に
は分離レベル 0 （ダーティ読み出し）が指定され、最初の接続には分
離レベル 1 （Read Committed 動作）が指定されます。
// 2 番目の接続が継承する分離レベル
SQLCA.Lock = "0"
接続リファレンス
225
読み込みのみ
CONNECT USING SQLCA;
// 1 番目の接続に限り、ロック値 0 を上書き
EXECUTE IMMEDIATE "set transaction isolation level 1";
例
例 1 Adaptive Server Anywhere データベースに対して、 Lock 値を RC
（Read Committed）に設定するには以下のようにします。
•
開発環境 DB プロファイル設定ダイアログボックスで、［分離レ
ベル］ドロップダウンリストの「Read Committed」を選択します。
•
アプリケーション
スクリプトに次のように入力します。
SQLCA.Lock="RC"
例 2 Sybase Adaptive Server Enterprise データベースに対して、 Lock 値
を 3 （Serializable Transactions）に設定するには以下のようにします。
•
開発環境 DB プロファイル設定ダイアログボックスで、［分離レ
ベル］ドロップダウンリストの「Serializable Transactions」を選択
します。
•
アプリケーション
スクリプトに次のように入力します。
SQLCA.Lock="3"
コードでの例の使用データベースプロファイルで分離レベルを指定
すると、構文が DB プロファイル設定ダイアログボックスの［プレ
ビュー］タブに表示されます。その構文を［プレビュー］タブからス
クリプトにコピーできます。
読み込みのみ
機能
PowerBuilder が、拡張属性システムテーブルや、データベース内のほ
かのテーブルを更新するかどうかを指定します。拡張属性システム
テーブル（拡張カタログ）は、使用しているデータベースのデフォル
ト拡張属性情報を含んだ 5 つのテーブルで構成されています。
［読み込みのみ］の設定は、データベース内のテーブルを変更（更新）
できるかどうかを決定します。デフォルトでは、 DB 環境設定プロパ
ティシートの［読み込みのみ］チェックボックスはオフになっていま
す。つまり、拡張属性システムテーブルや、データベース内のほかの
テーブルは、変更を加えると更新されます。
［読み込みのみ］チェックボックスをオンにすると、PowerBuilder では、
拡張属性システムテーブルや、データベース内のほかのテーブルは更
新されません。また、データウィンドウペインタから、拡張属性シス
テムテーブルなどのデータベーステーブルの情報を変更（更新）でき
ません。
226
PowerBuilder
第2章
データベース環境設定項目
対象
すべてのデータベースインタフェース
アプリケーションの場
合
コードには、読み込みのみのデータベース環境設定項目を設定できま
せん。
開発環境の場合
データベースペインタで、 DB 環境設定プロパティシートの［読み込
みのみ］チェックボックスをオンまたはオフにします。
•
チェックボックスをオンにするデータベース内のテーブル（拡張属
性システムテーブルなど）を更新しません。［読み込みのみ］チェッ
クボックスがオンの場合、データウィンドウペインタから、拡張
属性システムテーブルなどのデータベーステーブルの情報を変
更（更新）できません。
•
チェックボックスをオフにする
（デフォルト）拡張属性システム
テーブルなどの、データベース内のテーブルに変更が加えられる
と、更新します。
デフォルト値
DB 環境設定プロパティシートの［読み込みのみ］チェックボックス
は、デフォルトでオフに設定されています。
解説
DB 環境設定プロパティシートの［読み込みのみ］チェックボックス
をオンにすると、データウィンドウペインタからテーブル内の情報を
変更することはできません。
このため、以下を使用することができます。
関連項目
•
データウィンドウペインタおよびレポートペインタの SELECT
文と Retrieve 文
•
埋め込み SQL の SELECT 文
拡張属性の使用
共有 DB プロファイル
機能
共有させたいデータベースプロファイルを含んだ PowerBuilder 初期設
定ファイルのパス名を指定します。
PowerBuilder 開発環境の共有データベースプロファイルについての詳
細は、『データベースとの接続』マニュアルの「データベース接続の管
理」を参照してください。
対象
すべてのデータベースインタフェース
アプリケーションの場
合
コードには、共有 DB プロファイルデータベース環境設定項目を設定
できません。
接続リファレンス
227
SQL 構文の終止符
開発環境の場合
データベースペインタで、 DB 環境設定プロパティシートの［共有
DB プロファイル］ボックスに共有ファイルを含んだ PowerBuilder 初
期設定ファイルのパス名を指定します。パス名は、直接入力または参
照（［...］）ボタンをクリックして、指定できます。
詳細については、『データベースとの接続』マニュアルの「接続パラ
メータの設定」を参照してください。
デフォルト値
DB 環境設定プロパティシートの［共有 DB プロファイル］ボックス
は、デフォルトでは空白（未指定）です。
例
Windows プラットフォーム上の I:\SHARE\PB.INI に含まれるデータ
ベースプロファイルを共有するには、 DB 環境設定プロパティシート
の［共有 DB プロファイル］ボックスに、以下を入力するか参照（［...］）
ボタンで指定します。
I:\SHARE\PB.INI
SQL 構文の終止符
機能
データベースペインタの対話型 SQL （ISQL）セッションビューが使
う SQL 構文の終止符を指定します。
ISQL セッションビューのデフォルトの終止符は、セミコロン（;）で
す。セミコロンが DBMS 構文で使われている終止符と衝突する場合
は、ペインタの終止符を DB 環境設定プロパティシートの［SQL 構文
の終止符］ボックスで、別の文字に指定することができます。その際、
バッククォート文字（`）を選ぶとよいでしょう。
ストアドプロシージャ、トリガ、 SQL スクリプトを作成または実行す
る ISQL セッションビューを使用している場合には、終止符を変更す
ることをお勧めします。
対象
すべてのデータベースインタフェース
アプリケーションの場
合
コードでは、データベース環境設定で SQL 構文の終止符を設定するこ
とはできません。
開発環境の場合
データベースペインタの DB 環境設定プロパティシートで、［SQL 構
文の終止符］ボックスに使用したい終止符を入力します。詳細につい
ては、『データベースとの接続』マニュアルの「接続パラメータの設
定」を参照してください。
デフォルト値
DB 環境設定プロパティシートのデフォルトの SQL 終止符の値は、セ
ミコロン（;）です。
228
PowerBuilder
第2章
解説
データベース環境設定項目
以下は、デフォルトの SQL 終止符の値を変更する必要がある場合に行
う一般的な処理です。
•
ISQL セッションビューでス
トアドプロシージャとトリガを作成している場合、ペインタの終
止符をバッククォート文字（`）のような、ストアドプロシージャ
またはトリガの DBMS 構文で使用しない文字に変更します。
ストアドプロシージャとトリガの作成
ストアドプロシージャを使用した後、終止符をセミコロン（;）に
変更できます。新規の終止符を使用する方が都合がよければ、衝
突するストアドプロシージャまたはトリガ構文がない限り、継続
して使用できます。
•
例
ISQL セッションビューで SQL スクリプト
を実行する場合は、スクリプトで使用される終止符が、現在ビュー
で設定されている終止符と一致しているかどうか確認してくださ
い。
SQL スクリプトの実行
ISQL セッションビューの SQL 構文の終止符をバッククォート（`）に
戻すには、DB 環境設定プロパティシートの［SQL 構文の終止符］ボッ
クスにバッククォートを入力します。
拡張属性の使用
機能
PowerBuilder に拡張属性システムテーブルを作成させるかどうかを指
定することで、拡張属性システムテーブルへのアクセスを制御しま
す。拡張属性システムテーブル（拡張カタログ）は、使用している
データベースのデフォルト拡張属性情報を含んだ 5 つのテーブルで構
成されています。
デフォルトでは、 DB 環境設定プロパティシートの［拡張属性の使用］
チェックボックスは、オンになっています。オンになっている場合は、
PowerBuilder を使って最初にデータベースに接続するときに、拡張属
性システムテーブルを作成します。
対象
すべてのデータベースインタフェース
アプリケーションの場
合
コードでは、データベース環境設定で［拡張属性の使用］を設定する
ことはできません。
開発環境の場合
データベースペインタで、 DB 環境設定プロパティシートの［拡張属
性の使用］チェックボックスをオンまたはオフにします。
•
接続リファレンス
チェックボックスをオンにする（デフォルト）最初にデータベース
に接続するときに、拡張属性システムテーブルを作成します。
229
拡張属性の使用
•
チェックボックスをオフにする拡張属性システムテーブルがない
場合は、新規に作成しません。そのかわりに、データウィンドウ
ペインタが、拡張属性に対する適切なデフォルト値（ヘッダ、ラ
ベル、テキストの色など）を使用します。拡張属性システムテー
ブルがすでにある場合は、新規のデータウィンドウオブジェクト
の作成時に、 PowerBuilder で拡張属性システムテーブルは使用さ
れません。
デフォルト値
DB 環境設定プロパティシートの［拡張属性の使用］チェックボック
スは、デフォルトでオンになっています。
解説
DB 環境設定プロパティシートの［拡張属性の使用］チェックボック
スをオフにした場合、以下の作業はいずれも行われません。
関連項目
230
•
拡張属性システムテーブルの作成
•
拡張属性システムテーブル内の行の挿入、更新、削除
•
拡張属性システムテーブルからの情報（ヘッダ名など）の選択
•
拡張属性システムテーブルを参照する文の実行
読み込みのみ
PowerBuilder
索引
A
D
AppName データベースパラメータ 6
Async データベースパラメータ 7
AutoCommit データベース環境設定項目 217
AutoCommit トランザクションオブジェクトプロ
パティ 217
Database データベースパラメータ 35
DataLink データベースパラメータ 36
DataSource データベースパラメータ 37
Date 型書式 38, 40
Date データベースパラメータ 38
DateFormat データベースパラメータ 40
DateTime 型書式 42, 46
DateTime データ型、固有キーカラム 44
DateTime データベースパラメータ 42
DateTimeAllowed データベースパラメータ 44
DateTimeFormat データベースパラメータ 46
DB 環境設定プロパティシートの［拡張属性の使
用］チェックボックス 229
DB 環境設定プロパティシートの［共有 DB プロ
ファイル］ボックス 227
DB 環境設定プロパティシートの［デフォルトの
プロファイルに接続］チェックボックス
220
DB 環境設定プロパティシートの［読み込みのみ］
チェックボックス 226
［DB の接続を保持］のデータベース環境設定
221
DB プロファイル設定ダイアログボックス
［自動コミットモード］チェックボックス
217
［分離レベル］ボックス 96, 222
DB プロファイル設定ダイアログボックスの［分
離レベル］ボックス 96
DB2SYSPB.SQL スクリプト、 PBCatalogOwner デー
タベース 130
DBA、 Adaptive Server Anywhere ストアドプロシー
ジャのオーナ 136
DBGetTime データベースパラメータ 47
DBMS
Lock 値と分離レベル 96, 222
それぞれでサポートされているデータベースパ
ラメータ 1
それぞれでサポートされているデータベース環
B
BindSPInput データベースパラメータ 9
BinTxtBlob データベースパラメータ 10
Block データベースパラメータ
ODBC 11
OLE DB 11
Oracle 11
Sybase Adaptive Server Enterprise 14
C
CacheAuthentication データベースパラメータ 15
CacheName データベースパラメータ 16
CallEscape データベースパラメータ 17
CDB 値、 ODBC 接続文字列内 29
CharSet データベースパラメータ 18
CnnPool データベースパラメータ 19
COM+
TransactionServer オブジェクトの使用 211
オプション 123
CommitOnDisconnect データベースパラメータ
21
ConnectAs データベースパラメータ 23
ConnectOption データベースパラメータ 24
ConnectString データベースパラメータ 29
CursorLib データベースパラメータ 31
CursorLock データベースパラメータ 31
CursorScroll データベースパラメータ 33
CursorUpdate データベースパラメータ 34
接続リファレンス
231
索引
境設定項目 215
DBParm ぱらめーた
MaxFetchBuffer, Oracle 107
DBTextLimit データベースパラメータ 48
DDL 文、 SQL 218
DecimalSeparator データベースパラメータ 49
DelimitIdentifier データベースパラメータ 52, 86
DisableBind データベースパラメータ 53, 93, 188
DisableUnicode データベースパラメータ 57
Driver データベースパラメータ 58
DS_Alias データベースパラメータ 59
DS_Copy データベースパラメータ 61
DS_DitBase データベースパラメータ 64
DS_Failover データベースパラメータ 68
DS_Password データベースパラメータ 70
DS_Principal データベースパラメータ 72
DS_Provider データベースパラメータ 74
DS_TimeLimit データベースパラメータ 76
DSN （データソース名）値、 ODBC 接続文字列内
29
H
Host データベースパラメータ
84
I
EAServer 接続キャッシュ
オプション 82
接続の解除 143, 153
設定 16
EAServer、 TransactionServer オブジェクトの使用
211
EncryptPassword データベースパラメータ 77
IBM Informix データベースインタフェース、
「Informix データベースインタフェース」を
参照 215
IdentifierQuoteCharacter データベースパラメータ
86
ImpersonationLevel データベースパラメータ 88
INET_DBPATH データベースパラメータ 89
INET_PROTOCOL データベースパラメータ 90
INET_SERVICE データベースパラメータ 91
Informix データベースインタフェース
INET_DBPATH データベースパラメータ 89
INET_PROTOCOL データベースパラメータ
90
INET_SERVICE データベースパラメータ 91
Lock 値と分離レベル 223
ThreadSafe データベースパラメータ 198
カーソルスクロールオプション、設定 157
小数点記号、設定 49
データベースパラメータ 1
データベース環境設定項目 215
Init_Prompt データベースパラメータ 92
InsertBlock データベースパラメータ 93
IntegratedSecurity データベースパラメータ 95
Isolation データベースパラメータ 96
F
J
FoDelay データベースパラメータ 78, 79
FoRetryCount データベースパラメータ 80
FormatArgsAsExp データベースパラメータ 81
Java VM、指定 97
JavaVM データベースパラメータ 97
JDBC データベースインタフェース
Date 型書式 38
DateTime 型書式 42
EAServer 接続キャッシュ、オプション
EAServer 接続キャッシュ、接続の解除
153
EAServer 接続キャッシュ、設定 16
Java VM、指定 97
E
G
GetConnectionOption データベースパラメータ
232
82
82
143,
PowerBuilder
索引
Lock 値と分離レベル 223
Time 型書式 200, 202
TransactionServer オブジェクト、使用 211
エラーメッセージ、簡略表示 110
数値書式、設定 116
データベース URL、設定 209
データベースパラメータ 1
データベース環境設定項目 215
［テーブルの選択］リスト、変更 197
ドライバ名、設定 58
トレース、設定 206
プロパティ、設定 104, 139
ログインのタイムアウト、設定 104
98
L
Language データベースパラメータ 99
Locale データベースパラメータ 101
Location データベースパラメータ 102
Lock Transaction オブジェクトプロパティ 96,
222
Lock 値と分離レベル 96, 222
アプリケーションでの動的制御 225
Lock データベース環境設定 222
Log データベースパラメータ 103
LOG ファイル、 Adaptive Server 103
LoginTimeOut データベースパラメータ 104
LUW 217
M
MapDateToDateTime データベースパラメータ
104
MaskPassword データベースパラメータ 105
MaxConnect データベースパラメータ 106
MaxFetchBuffer
Block データベースパラメータ 13
接続リファレンス
N
Namespace データベースパラメータ 112
NCharBind データベースパラメータ 112
NLS_Charset データベースパラメータ 114
NumbersInternal データベースパラメータ 115
NumericFormat データベースパラメータ 116
O
K
KeepAlive データベースパラメータ
MaxFetchBuffer データベースパラメータ
Oracle 107
MixedCase データベースパラメータ 108
Mode データベースパラメータ 109
MsgTerse データベースパラメータ 110
ObjectMode データベースパラメータ 119
ODBC インタフェース
ConnectOption データベースパラメータ、使用
24
Date 型書式 38
DateTime 型書式 42
EAServer 接続キャッシュ、接続の解除 143,
153
EAServer 接続キャッシュ、設定 16
Jaguar 接続キャッシュ、オプション 82
Lock 値と分離レベル 223
RPC、再バインド 155, 156
Time 型書式 200, 202
TransactionServer オブジェクト、使用 211
エラーメッセージ、簡略表示 110
カーソルスクロールオプション、設定 33
カーソルブロックファクタ、設定 11
カーソルライブラリ、設定 31
カーソルロックオプション、設定 31
小数点記号、設定 49
数値書式、設定 116
接続文字列、設定 29
データパイプラインペインタでの行の挿入
93
データベースパラメータ 1
データベース環境設定項目 215
233
索引
［テーブルの選択］リスト、変更 197
ネットワークパケットサイズ、設定 126
パラメータ名を取る 193
ログインのタイムアウト、設定 104
ODBC 接続文字列 29
ODBC データソース
ConnectString データベースパラメータ内のデータ
ソース名（DSN） 29
Date 型書式 38
DateTime 型書式 42
Lock 値と分離レベル 223
RPC、再バインド 155
SQL 文のキャッシュ 188
Time 型書式 200, 202
カーソルスクロールオプション、設定 33
カーソルライブラリ、設定 31
カーソルロックオプション、設定 31
接続文字列、設定 29
データベースパラメータ 1
データベース環境設定項目 215
RPC、再バインド 156
エラーメッセージ、簡略表示 110
データパイプラインペインタでの行の挿入 93
ネットワークパケットサイズ、設定 126
ODBC ドライバ
Lock 値と分離レベル 223
RPC、再バインド 155, 156
SQL 文のキャッシュ 188
エラーメッセージ、簡略表示 110
カーソルスクロールオプション、設定 33
カーソルライブラリ、設定 31
カーソルロックオプション、設定 31
数値書式、設定 116
接続文字列、設定 29
データベースパラメータ 1
データベース環境設定項目 215
ネットワークパケットサイズ、設定 126
ログインのタイムアウト、設定 104
ODBC ドライバマネージャトレース、 ConnectOption
データベースパラメータによる設定 24
ODBC のストアドプロシージャ、オーナ名の修飾
135
ODBCU_CONLIB データベースパラメータ 120
234
OJSyntax データベースパラメータ 121
OLE DB
ServerCursor データベースパラメータ 13
パフォーマンスの改善 13
OLE DB インタフェース
後続スペースの削除 134
OLE DB データベースインタフェース
Blob の最大サイズ、指定 131
Date 型書式 40
DateTime 型書式 46
Lock 値と分離レベル 223
SQL Server データベース、指定 142
アクセスパーミッション 109
暗号化パスワードの保存 137
インパーソネーションレベル 88
カーソルブロックファクタ、設定 11
最大 Blob サイズ、指定 149
タイムアウトの設定 21
タイムアウト、設定 204
データソース、指定 37
データプロバイダ、指定 141
データリンクファイル、使用 35, 36
データベースサーバ名、識別 102
データベースパラメータ 1
データベース環境設定項目 215
データ保護レベル、指定 140
認証サービス、指定 95
認証情報のキャッシュ 15
認証情報の保存 138
パスワードの暗号化 77, 78
パスワードのマスク化 105
プロンプト、設定 92
ロケール識別子、設定 100
Oracle データベースインタフェース
COM+ コンポーネント、オプション 123
Date 型書式 38
DateTime 型書式 42
EAServer 接続キャッシュ、接続の解除 153
EAServer 接続キャッシュ、設定 16
Jaguar 接続キャッシュ、オプション 82
NumbersInternal データベースパラメータ 115
Oracle の内部数値書式の使用 115
PowerBuilder
索引
PackageProcs データベースパラメータ 125
PUBLIC 修飾子の使用 148
QualifyPublic データベースパラメータ 148
SQL 文のキャッシュ 188
ThreadSafe データベースパラメータ 198
Time 型書式 200, 202
TransactionServer オブジェクト、使用 211
大文字と小文字の区別、設定 108
オブジェクトモード 119
カーソルブロックファクタ、設定 11
小数点記号、設定 49
データベースパラメータ 1
データベース環境設定項目 215
［テーブルの選択］リスト、変更 197
パスワードが期限切れですダイアログボック
ス、表示 132, 144, 147
パッケージオブジェクトの一覧表示 125
フェイルオーバ 79, 80, 194
フェッチバッファサイズ , 設定 107
Oracle8i のユーロ記号 57
OraMTSConFlgs データベースパラメータ 123
P
PackageProcs データベースパラメータ 125
Packet Size データベースパラメータ 127
ODBC で使用 126
PBCatalogOwner データベースパラメータ 128
PBMaxBlobSize データベースパラメータ 131
PBNewSPInvocation データベースパラメータ
132
PBNoCatalog データベースパラメータ 133
PBTrimCharColumns データベースパラメータ
134
PBUseProcOwner データベースパラメータ 135
PersistEncrypted データベースパラメータ 137
PersistSecurityInfo データベースパラメータ 138
Properties データベースパラメータ 139
ProtectionLevel データベースパラメータ 140
Provider データベースパラメータ 141
ProviderString データベースパラメータ 142
ProxyUserName データベースパラメータ 143
PWDialog データベースパラメータ 144
接続リファレンス
PWD （パスワード）値、 ODBC 接続文字列内
PWEncrypt データベースパラメータ 146
PWExpDialog データベースパラメータ 147
29
Q
QualifyPublic データベースパラメータ
148
R
RecheckRows データベースパラメータ 149
Release データベースパラメータ 150
ReleaseConnectionOption データベースパラメータ
153
RetrieveRow イベント、非同期処理の記述 7
ReturnCommandHandle データベースパラメータ
156
RPCRebind データベースパラメータ 155
RPC、 ODBC データソースの再バインド 155,
156
S
Scroll データベースパラメータ 157
Sec_Channel_Bind データベースパラメータ 158
Sec_Confidential データベースパラメータ 160
Sec_Cred_Timeout データベースパラメータ 162
Sec_Data_Origin データベースパラメータ 165
Sec_Delegation データベースパラメータ 167
Sec_Keytab_File データベースパラメータ 169
Sec_Mechanism データベースパラメータ 171
Sec_Mutual_Auth データベースパラメータ 174
Sec_Network_Auth データベースパラメータ 175
Sec_Replay_Detection データベースパラメータ
178
Sec_Seq_Detection データベースパラメータ 180
Sec_Server_Principal データベースパラメータ
182
Sec_Sess_Timeout データベースパラメータ 184
ServerCursor データベースパラメータ 13
ServiceComponents データベースパラメータ 186
ShowWarnings データベースパラメータ 187
235
索引
［SQL 構文の終止符］のデータベース環境設定項目
228
SQL 構文の終止符、データベースペインタでの変更
228
SQL データ定義言語（DDL）文 218
SQL ファイル、 DB2SYSPB.SQL 130
SQL 文
キャッシュ 55, 188
固有キーカラムとして DateTime カラムを許可
44
テーブルとカラムの区切り 86
トランザクションの内側か外側で発行 217
バインド変数 53
SQL 文のキャッシュ
概要 188
バインド変数による 55, 188
SQLCache データベースパラメータ 188
SQLSTATE エラープレフィクス、表示の抑制 110
StaticBind データベースパラメータ 190
StrByCharset データベースパラメータ 192
StripParmNames データベースパラメータ 193
SvrFailover データベースパラメータ 194
Sybase Adaptive Server Anywhere
DBA、ストアドプロシージャのオーナ 136
ストアドプロシージャ、オーナ名での修飾 136
データベースパラメータ 1
データベース環境設定項目 215
Sybase Adaptive Server Enterprise データベースインタ
フェース
EAServer 接続キャッシュ、接続の解除 143, 153
EAServer 接続キャッシュ、設定 16
Jaguar 接続キャッシュ、オプション 82
Lock 値と分離レベル 223
TransactionServer オブジェクト、使用 211
アプリケーション名、設定 6
カーソルブロックファクタ、設定 14
カーソルの宣言 34
解放、設定 150
言語、設定 99
セキュリティサービスのデータベースパラメータ
158
ディレクトリサービスデータベースパラメータ
59
236
データベースパラメータ 1
データベース環境設定項目 215
［テーブルの選択］リスト、変更 197
テキストとイメージの更新内容の記録 103
パスワードが期限切れですダイアログボック
ス、表示 132, 144, 147
パスワードの暗号化 146
フェイルオーバ 194
分離レベル、アプリケーションでの動的制御
225
文字セット、設定 18
ロケール、設定 101
Sybase Adaptive Server Enterprise の UNIX 上での分
散アプリケーションインタフェース
データベースパラメータ 1
Sybase Open Client セキュリティサービス
Release データベースパラメータ 150
Sec_Channel_Bind データベースパラメータ
158
Sec_Confidential データベースパラメータ 160
Sec_Cred_Timeout データベースパラメータ
162
Sec_Data_Integrity データベースパラメータ
163
Sec_Data_Origin データベースパラメータ 165
Sec_Delegation データベースパラメータ 167
Sec_Keytab_File データベースパラメータ 169
Sec_Mechanism データベースパラメータ 171
Sec_Mutual_Auth データベースパラメータ
174
Sec_Network_Auth データベースパラメータ
175
Sec_Replay_Detection データベースパラメータ
178
Sec_Seq_Detection データベースパラメータ
180
Sec_Server_Principal データベースパラメータ
182
Sec_Sess_Timeout データベースパラメータ
184
Sybase Open Client ディレクトリサービス
DS_Alias データベースパラメータ 59
PowerBuilder
索引
い
DS_Copy データベースパラメータ 61
DS_DitBase データベースパラメータ 64
DS_Failover データベースパラメータ 68
DS_Principal データベースパラメータ 70, 72
DS_Provider データベースパラメータ 74
DS_TimeLimit データベースパラメータ 76
Release データベースパラメータ 150
サードパーティのディレクトリサービスプロ
バイダ 74
Sybase Open Client ディレクトリサービスの DIT
ベース
例 65
SYSIBM、 DB2 テーブルオーナの名前としては使
用できない 130
SystemProcs データベースパラメータ 196
大文字と小文字の区別、 Oracle データベース
108
T
か
TableCriteria データベースパラメータ 197
ThreadSafe データベースパラメータ 198
Time 型書式 200, 202
Time データベースパラメータ 200, 202
TimeOut データベースパラメータ 21, 204
TimeStamp データベースパラメータ 204
TraceFile データベースパラメータ 206
TransactionServer オブジェクト、使用 211
TrimSpaces データベースパラメータ 207
TrustedConnection データベースパラメータ 208
カーソル
ConnectOption データベースパラメータでの設
定 24
キーセット駆動、 ODBC 33
更新特性 34
混成、 ODBC 33
スクロールオプション、 Informix インタフェー
ス 157
スクロールオプション、 ODBC 33
ブロックファクタ 11
ブロックファクタ、 Sybase Adaptive Server
Enterprise 14
ライブラリ、 ODBC 31
ロックオプション、 ODBC 31
拡張属性システムテーブル
［拡張属性の使用］のデータベース環境設定項
目による作成の制御 229
拡張属性システムテーブル、［読み込みのみ］
データベース環境設定項目による更新の制
御 226
拡張属性システムテーブル
テーブルオーナ、設定 128
［拡張属性の使用］のデータベース環境設定項目
229
カッコ（右）、 SQL 構文の終止符 228
U
UID （ユーザ ID）値、 ODBC 接続文字列内
Unicode
Blob データ 10
Oracle8i 57
URL データベースパラメータ 209
URL、 JDBC 内での使用 209
UseContextObject データベースパラメータ
UTF8 データベースパラメータ 213
接続リファレンス
29
211
インデックス
名前の区切り記号 86
名前を二重引用符で囲む
52
え
エラーメッセージ、簡略表示
110
お
237
索引
カラム
DateTime データ型 44
デフォルト値とバインド変数
名前の区切り記号 86
名前を二重引用符で囲む 52
す
55
き
キーセット駆動カーソル
ODBC 33
キャッシュ、バインド変数と SQL 文 188
［共有 DB プロファイル］のデータベース環境設定項
目 227
共有データベースプロファイル、セットアップ 227
け
結果セット、検索前の情報の取得
検索引数、指数表記 81
検索、非記述 190
190
スクロールオプション、カーソル
Informix インタフェース 157
ODBC 33
ストアドプロシージャ、 Adaptive Server Enterprise、
表示 196
ストアドプロシージャ、 Oracle
SQL 構文の終止符の変更 228
ストアドプロシージャ、 SQL Server
および AutoCommit 218
表示 196
せ
セキュリティ、 ConnectOption データベースパラ
メータでの設定 24
接続文字列、 ODBC 29
セミコロン、 SQL 構文のデフォルトの終止符
228
た
こ
混成カーソル、 ODBC
ダーティ読み出し
225
33
て
さ
最適化同時実行制御
32
し
指数表記、検索引数 81
［自動コミットモード］チェックボックス、 DB プロ
ファイル設定ダイアログボックス 217
小数点記号
DecimalSeparator データベースパラメータでの設定
49
NumericFormat DBParm を使用した設定 118
238
データパイプラインペインタ
簡易エラーメッセージの表示 111
行を一度に挿入 93
データリンクファイル、 OLE DB 内での使用
データウィンドウオブジェクト
検索前の結果セット情報の取得 190
非同期処理 7
データソース、 OLE DB 内での指定 37
データ定義言語（DDL）文、 SQL 218
データベース
Lock 値と分離レベル 96, 222
更新の制御 226
接続の保持 221
データベースインタフェース
データベースパラメータ 1
36
PowerBuilder
索引
データベース環境設定項目 215
データベースパラメータ 100
AppName 6
Async 7
BinTxtBlob 10
Block、 ODBC 11
Block、 OLE DB 11
Block、 Oracle 11
Block、 Sybase Adaptive Server Enterprise
CacheAuthentication 15
CacheName 16
CallEscape 17
CharSet 18
CnnPool 19
CommitOnDisconnect 21
ConnectAs 23
ConnectOption 24
ConnectString 29
CursorLib 31
CursorLock、 ODBC 31
CursorScroll、 ODBC 33
CursorUpdate 34
Database 35
DataLink 36
DataSource 37
Date 38
DateFormat 40
DateTime 42
DateTimeAllowed 44
DateTimeFormat 46
DBGetTime 47
DBTextLimit 48
DecimalSeparator 49
DelimitIdentifier 52, 86
DisableBind 53, 57, 93, 188
DS_Alias 59
DS_Copy 61
DS_DitBase 64
DS_Failover 68
DS_Password 70
DS_Principal 72
DS_Provider 74
DS_TimeLimit 76
EncryptPassword 77
FoDelay 78
FoDialog 79
接続リファレンス
14
FoRetryCount 80
FormatArgsAsExp 81
GetConnectionOption 82
Host 84
IdentifierQuoteCharacter 86
ImpersonationLevel 88
INET_DBPATH 89
INET_PROTOCOL 90
INET_SERVICE 91
Init_Prompt 92
InsertBlock 93
IntegratedSecurity 95
JavaVM 97
KeepAlive 98
Language 99
LCID 100
Locale 101
Location 102
Log 103
LoginTimeOut 104
MapDateToDateTime 104
MaskPassword 105
MaxConnect 106
MixedCase 108
Mode 109
MsgTerse 110
NumbersInternal 115
NumericFormat 116
ObjectMode 119
ODBCU_CONLIB 120
OJSyntax 121
OraMTSConFlgs 123
PackageProcs 125
PacketSize 127
PacketSize、 ODBC 126
PBCatalogOwner 128
PBMaxBlobSize 131
PBNoCatalog 133
PBTrimCharColumns 134
PBUseProcOwner 135
PersistEncrypted 137
PersistSecurityInfo 138
Properties 139
ProtectionLevel 140
Provider 141
ProviderString 142
239
索引
ProxyUserName 143
PWDialog 132, 144, 147
PWEncrypt 146
QualifyPublic 148
RecheckRows 149
Release 150
ReleaseConnectionOption 153
RPCRebind 155, 156
Scroll 157
Sec_Channel_Bind 158
Sec_Confidential 160
Sec_Cred_Timeout 162
Sec_Data_Origin 165
Sec_Delegation 167
Sec_Keytab_File 169
Sec_Mechanism 171
Sec_Mutual_Auth 174
Sec_Network_Auth 175
Sec_Replay_Detection 178
Sec_Seq_Detection 180
Sec_Server_Principal 182
Sec_Sess_Timeout 184
ServiceComponents 186
ShowWarnings 187
SQLCache 188
StaticBind 190
StripParmNames 193
SvrFailover 194
SystemProcs 196
TableCriteria 197
ThreadSafe 198
Time 200, 202
TimeOut 21, 204
TraceFile 206
TrimSpaces 207, 208
URL 209
UseContextObject 211
UTF8 213
サポートされているデータベースインタフェース
1
ドライバ 58
データベースプロファイル
ODBC データソースの接続文字列 29
［共有 DB プロファイル］のデータベース環境設定
項目のセットアップ 227
接続プール 19
240
データベース環境設定項目
AutoCommit 217
DB の接続を保持 221
SQL 構文の終止符 228
拡張属性の使用 229
共有 DB プロファイル 227
サポートされているデータベースインタフェー
ス 215
デフォルトのプロファイルに接続 220
読み込みのみ 226
ロック 222
データベースの更新、制御 226
データベースへの接続、接続の保持 221
データベースペインタ、 SQL 構文の終止符の変更
228
テーブル
更新の制御 226
［テーブルの選択］リスト、変更 197
名前の区切り記号 86
名前を二重引用符で囲む 52
［テーブルの選択］リスト、変更 197
テキストファイル
データベース環境設定項目 215
［デフォルトのプロファイルに接続］のデータベー
ス環境設定 220
と
同時実行制御、最適化 32
トランザクション
SQL 文を内部か外部で発行 217
ロックと分離レベル 96, 222
トランザクションログ、 Adaptive Server
103
に
認証サービス、 OLE DB データベースでの指定
95
認証情報、 OLE DB データベースへの保存 138
PowerBuilder
索引
は
ゆ
バインド変数
SQL 文内での使用 54
キャッシュされた SQL 文 55, 188
デフォルトバインドの無効化 53
デフォルトのカラム値 55
パケットサイズ、ネットワーク
ODBC データソースの設定 126
設定 127
パスワード
ConnectString データベースパラメータ内 29
OLE DB データベースでのマスク化 105
OLE DB データベースに暗号化して保存 137
OLE DB データベースの暗号化 77
Sybase Adaptive Server Enterprise データベース
での暗号化 146
バッククォート文字（`）、 SQL 構文の終止符
228
反復不能読み込み 225
ユーザ ID、 ConnectString データベースパラメータ
内 29
よ
［読み込みのみ］データベース環境設定 226
読み込み、ダーティおよび反復不能 225
ろ
ロック
DBMS 分離レベル 96, 222
アプリケーションでの分離レベルの動的制御
225
カーソル、 ODBC 31
ダーティ読み出し 225
反復不能読み込み 225
ファントム値 225
論理的な作業単位（LUW） 217
ひ
非記述検索 190
非同期処理、有効化
7
ふ
ファントム値 225
フェイルオーバ、 Oracle データベースでの使用
78, 79
ブロックファクタ、カーソルに対する設定 11,
14
分離レベルと Lock 値 96, 222
アプリケーションでの動的制御 225
［分離レベル］ボックス、 DB プロファイル設定
ダイアログボックス 222
も
文字セット、設定
接続リファレンス
18
241
索引
242
PowerBuilder