接続リ フ ァ レ ン ス
PowerBuilder®
9
DOCUMENT ID: 33820-01-0900-01
LAST REVISED: March 2003
Copyright © 1989-2004 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-FORMS, APT-Translator, APT-Library, 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, Distribution Director, e-ADK, E-Anywhere, 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,
ImpactNow, Industry Warehouse Studio, InfoMaker, Information Anywhere, Information Everywhere, InformationConnect,
InternetBuilder, iScript, Jaguar CTS, jConnect for JDBC, MainframeConnect, Maintenance Express, MDI Access Server, MDI
Database Gateway, media.splash, MetaWorks, 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++, PB-Gen, PC APT
Execute, PC Net Library, 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, Report Workbench,
Report-Execute, Replication Agent, Replication Driver, Replication Server, Replication Server Manager, Replication Toolkit, Resource
Manager, RW-DisplayLib, 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, TradeForce, Transact-SQL, UltraLite.NET, UNIBOM, Unilib,
Uninull, Unisep, Unistring, URK Runtime Kit for UniCode, Viewer, Visual Components, VisualSpeller, 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, XA-Server お よ び
XP Server は Sybase, Inc. の登録商標です。
Unicode お よ び Unicode の ロ ゴは Unicode, Inc. の登録商標です。
本書で使用 さ れ る 会社名お よ び製品名はそれぞれの会社の商標お よ び登録商標です。
本書に記載 さ れてい る 内容は、 将来予告な し に変更す る こ と があ り ま す。 ま た、 本 ソ フ ト ウ ェ アお よ び説明書を使用 し た
こ と に よ る 損害、 ま たは第三者か ら のいかな る 請求について も 、 サ イ ベー ス株式会社、 その親会社であ る 米国法人 Sybase,
Inc. ま たはその関連会社は、 一切の責任を負わない も の と し ま す。
目次
本書について ................................................................................................................................. vii
第1章
接続 リ フ ァ レ ン ス
DBParm パラ メ ー タ の解説 ..................................................................................... 1
DBParm パ ラ メ ー タ と
サポー ト さ れてい る デー タ ベース イ ン タ フ ェ ース ........... 1
AppName .................................................................................. 6
Async......................................................................................... 7
AtAtIdentity ................................................................................ 9
Block （ODBC、 OLE DB、 Oracle） ......................................... 11
Block （Adaptive Server Enterprise） ....................................... 13
CacheAuthentication ............................................................... 14
CacheName ............................................................................ 15
CallEscape .............................................................................. 16
CharSet ................................................................................... 17
CnnPool................................................................................... 18
CommitOnDisconnect ............................................................. 20
ConnectAs............................................................................... 21
ConnectOption ........................................................................ 22
ConnectString.......................................................................... 28
CursorLib ................................................................................. 30
CursorLock （ODBC） .............................................................. 30
CursorLock （Microsoft SQL Server) ....................................... 32
CursorScroll （ODBC） ............................................................ 33
CursorScroll （Microsoft SQL Server） ..................................... 35
CursorUpdate .......................................................................... 38
DataLink .................................................................................. 39
DataSource ............................................................................. 40
Date ......................................................................................... 41
DateFormat ............................................................................. 44
DateTime ................................................................................. 45
DateTimeAllowed .................................................................... 48
DateTimeFormat ..................................................................... 50
DBGetTime.............................................................................. 51
DBTextLimit ............................................................................. 52
iii
目次
DecimalSeparator.................................................................... 53
DelimitIdentifier........................................................................ 55
DisableBind ............................................................................. 56
Driver ....................................................................................... 60
DS_Alias.................................................................................. 61
DS_Copy ................................................................................. 63
DS_DitBase ............................................................................. 65
DS_Failover............................................................................. 69
DS_Password.......................................................................... 71
DS_Principal............................................................................ 73
DS_Provider ............................................................................ 75
DS_TimeLimit .......................................................................... 78
EncryptPassword .................................................................... 79
FoDelay ................................................................................... 80
FoDialog .................................................................................. 81
FoRetryCount .......................................................................... 82
FormatArgsAsExp ................................................................... 83
GetConnectionOption .............................................................. 85
Host ......................................................................................... 86
IdentifierQuoteChar ................................................................. 88
ImpersonationLevel ................................................................. 90
INET_DBPATH........................................................................ 91
INET_PROTOCOL .................................................................. 92
INET_SERVICE ...................................................................... 93
Init_Prompt .............................................................................. 94
InsertBlock............................................................................... 95
IntegratedSecurity ................................................................... 97
JavaVM ................................................................................... 98
KanjiEsc .................................................................................. 99
Language .............................................................................. 100
LCID ...................................................................................... 101
Locale .................................................................................... 102
Location ................................................................................. 104
Log ........................................................................................ 104
LoginTimeOut ........................................................................ 105
MaskPassword ...................................................................... 106
MaxConnect .......................................................................... 107
MixedCase ............................................................................ 108
Mode ..................................................................................... 109
MsgTerse .............................................................................. 110
NumbersInternal .................................................................... 111
NumericFormat...................................................................... 112
ObjectMode ........................................................................... 115
OJSyntax ............................................................................... 116
iv
PowerBuilder
目次
OptSelectBlob .......................................................................
OraMTSConFlgs ...................................................................
PackageProcs .......................................................................
PacketSize （ODBC）.............................................................
PacketSize ............................................................................
PBCatalogOwner...................................................................
PBMaxBlobSize.....................................................................
PBUseProcOwner .................................................................
PersistEncrypted ...................................................................
PersistSensitive .....................................................................
Properties ..............................................................................
ProtectionLevel......................................................................
Provider .................................................................................
ProviderString........................................................................
ProxyUserName ....................................................................
PWDialog ..............................................................................
PWEncrypt ............................................................................
QualifyPublic .........................................................................
Release .................................................................................
ReleaseConnectionOption ....................................................
RPCRebind ...........................................................................
Scroll .....................................................................................
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 ...............................................................
Secure ...................................................................................
ServiceComponents ..............................................................
SQLCache.............................................................................
StaticBind ..............................................................................
StripParmNames ...................................................................
SvrFailover ............................................................................
SystemProcs .........................................................................
TableCriteria..........................................................................
接続 リ フ ァ レ ン ス
118
120
122
123
124
126
128
129
131
132
133
134
135
137
138
139
141
142
143
145
146
147
149
151
153
155
157
158
160
163
165
167
169
172
174
176
178
179
180
183
185
186
188
189
v
目次
第2章
ThreadSafe............................................................................
Time ......................................................................................
TimeFormat ...........................................................................
TimeOut.................................................................................
TraceFile ...............................................................................
TrimSpaces ...........................................................................
URL .......................................................................................
UseContextObject .................................................................
190
192
195
196
197
198
199
200
デー タ ベース環境設定項目の解説 ..................................................................
デー タ ベース環境設定項目 と
サポー ト さ れてい る デー タ ベース イ ン タ フ ェ ース .......
AutoCommit...........................................................................
デ フ ォル ト のプ ロ フ ァ イルに接続 ........................................
DB の接続を保持 ...................................................................
Lock .......................................................................................
読み込みのみ .........................................................................
共有 DB プ ロ フ ァ イル...........................................................
SQL 構文の終止符.................................................................
拡張属性の使用 .....................................................................
203
203
205
208
209
210
215
216
217
218
索引 ............................................................................................................................................. 221
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
第 1 章
DBParm パ ラ メ ー タ の解説
この章につい て
こ の章では、 PowerBuilder において設定で き る DBParm パ ラ メ ー
タ の、 構文 と 使用方法について解説 し ま す。
PowerScript での DBParm パ ラ メ ー タ の設定
DB 接続プ ロ フ ァ イ ル ダ イ ア ロ グ ボ ッ ク ス の ［プ レ ビ ュ ー］ ペー
ジで、 PowerScript コ ー ド の正 し い構文を使用 し てい る こ と を確認
し て下 さ い。 多 く のブール値 DBParms は、 TRUE、 Yes、 1 のいず
れか を使用 し て オ ン にで き ま す。 ま た、 FALSE、 No、 0 を使用 し
て オ フ にで き ま す。 DBParm パ ラ メ ー タ に設定す る 数値は引用符
で囲わないで く だ さ い。
DBParm パ ラ メ ー タ と サポー ト さ れてい るデー タ ベース
イ ン タ フ ェ ース
次の表に、 サポー ト さ れてい る デー タ ベー ス イ ン タ フ ェ ー ス と 、
PowerBuilder におい て そ の イ ン タ フ ェ ー ス で使用で き る DBParm
パ ラ メ ー タ を示 し ま す。
DBParm パ ラ メ ー タ は、次の表で アルフ ァ ベ ッ ト 順に解説 さ れてい
ま す。
デー タ ベース
イ ン タ フ ェ ース
IN9 Informix
接続 リ フ ァ レ ン ス
DBParm パ ラ メ ー タ
Async
CommitOnDisconnect
DateTimeAllowed
DBGetTime
DecimalSeparator
DelimitIdentifier
DisableBind
INET_DBPATH
INET_PROTOCOL
INET_SERVICE
OJSyntax
Scroll
ThreadSafe
1
DBParm パ ラ メ ー タ と サポー ト さ れてい る デー タ ベース イ ン タ フ ェ ース
デー タ ベース
イ ン タ フ ェ ース
JDBC
MSS Microsoft SQL Server
2
DBParm パ ラ メ ー タ
Async
CacheName
CommitOnDisconnect
Date
DateTime
DBGetTime
DelimitIdentifier
DisableBind
Driver
FormatArgsAsExp
GetConnectionOption
IdentifierQuoteChar
JavaVM （JDB のみ）
LoginTimeOut
AppName
Async
AtAtIdentity
CommitOnDisconnect
CursorLock （Microsoft SQL Server)
CursorScroll （Microsoft SQL Server）
DateTimeAllowed
DBGetTime
DBTextLimit
Host
MsgTerse
NumericFormat
OJSyntax
PBCatalogOwner
Properties
ProxyUserName
ReleaseConnectionOption
StaticBind
TableCriteria
Time
TraceFile
TrimSpaces
URL
UseContextObject
Language
Log
MaxConnect
OJSyntax
OptSelectBlob
PacketSize
PBCatalogOwner
Secure
StaticBind
SystemProcs
PowerBuilder
第1章
デー タ ベース
イ ン タ フ ェ ース
ODBC
DBParm パ ラ メ ー タ
Async
Block （ODBC、 OLE DB、 Oracle）
CacheName
ODBC での DBParms の使用
CallEscape
右に示 し た DBParm パ ラ
CommitOnDisconnect
メ ー タ は、 使用す る
ConnectOption
ODBC ド ラ イ バ と バ ッ ク
ConnectString
エ ン ド DBMS の両方が
CursorLib
こ の機能 をサポー ト し て
CursorLock （ODBC）
い る 場合にのみ、
CursorScroll （ODBC）
PowerBuilder ODBC イ ン
Date
タ フ ェ ー ス に よ っ てサ
DateTime
ポー ト さ れ ます。
DBGetTime
DecimalSeparator
DelimitIdentifier
DisableBind
FormatArgsAsExp
GetConnectionOption
OLE DB
接続 リ フ ァ レ ン ス
Block （ODBC、 OLE DB、 Oracle）
CacheAuthentication
CommitOnDisconnect
DataLink
DataSource
DateFormat
DateTimeFormat
DecimalSeparator
DelimitIdentifier
EncryptPassword
IdentifierQuoteChar
ImpersonationLevel
IntegratedSecurity
LCID
Location
DBParm パ ラ メ ー タ の解説
IdentifierQuoteChar
InsertBlock
LoginTimeOut
MsgTerse
NumericFormat
OJSyntax
PacketSize （ODBC）
PBCatalogOwner
PBUseProcOwner
ProxyUserName
ReleaseConnectionOption
RPCRebind
SQLCache
StaticBind
StripParmNames
TableCriteria
Time
UseContextObject
MaskPassword
Mode
OJSyntax
PBCatalogOwner
PBMaxBlobSize
PersistEncrypted
PersistSensitive
Init_Prompt
ProtectionLevel
Provider
ServiceComponents
StaticBind
TimeFormat
TimeOut
3
DBParm パ ラ メ ー タ と サポー ト さ れてい る デー タ ベース イ ン タ フ ェ ース
デー タ ベース
イ ン タ フ ェ ース
O73 Oracle 7.3
および
O84 Oracle 8.x と Oracle8i
および
O90 Oracle9i
4
DBParm パ ラ メ ー タ
Async
Block （ODBC、 OLE DB、 Oracle）
CacheName
CnnPool （Oracle9i のみ）
CommitOnDisconnect
ConnectAs （Oracle9i のみ）
Date
DateTime
DBGetTime
DecimalSeparator
DelimitIdentifier
DisableBind
FoDelay （8.1.5 以降のデー タ ベー ス
のみ）
FoDialog （8.1.5 以降の デー タ ベー
ス のみ）
FoRetryCount （8.1.5 以降 の デー タ
ベー ス のみ）
FormatArgsAsExp
GetConnectionOption
MixedCase
NumbersInternal
ObjectMode
OraMTSConFlgs（8.1.5 以降のデー
タ ベー ス のみ）
PackageProcs
PBCatalogOwner
PWDialog
QualifyPublic
ReleaseConnectionOption
SQLCache
StaticBind
SvrFailover （8.1.5 以 降 の デ ー タ
ベー ス のみ）
TableCriteria
ThreadSafe
Time
UseContextObject
PowerBuilder
第1章
デー タ ベース
イ ン タ フ ェ ース
SYC Sybase Adaptive
Server® Enterprise
DBParm パ ラ メ ー タ
AppName
Async
Block （Adaptive Server Enterprise）
CharSet
Release の設定
CommitOnDisconnect
DS_* およ び Sec_* DBParm
CursorUpdate
パ ラ メ ー タ を 使用す る に
DateTimeAllowed
は Release DBParm パ ラ
DBGetTime
メ ータ を 11 またはそれ以
DBTextLimit
上に設定す る 必要が あ り
DelimitIdentifier
ます。
DS_Alias
DS_Copy
DS_DitBase
DS_Failover
DS_Password
DS_Principal
DS_Provider
DS_TimeLimit
FormatArgsAsExp
Host
Language
Locale
Log
MaxConnect
SYJ Sybase Adaptive
Server Enterprise
接続 リ フ ァ レ ン ス
Block （Adaptive Server Enterprise）
CacheName
CursorUpdate
DBTextLimit
FormatArgsAsExp
GetConnectionOption
Log
DBParm パ ラ メ ー タ の解説
PacketSize
PBCatalogOwner
ProxyUserName
PWDialog
PWEncrypt
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
StaticBind
SvrFailover
SystemProcs
TableCriteria
TrimSpaces
PBCatalogOwner
ProxyUserName
ReleaseConnectionOption
StaticBind
SvrFailover
SystemProcs
TrimSpaces
UseContextObject
5
AppName
AppName
機能
PowerBuilder か ら デー タ ベー ス に接続す る と き に、 使用す る ア プ リ
ケーシ ョ ン の名前を指定 し ま す。 ただ し 、 DBMS が こ れを サポー ト し
て い る 場合に限 り ま す。
AppName を指定する タ イ ミ ン グ
AppName DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー ス に接
続す る 前に指定 し ま す。
対象
MSS Microsoft SQL Server
SYC Sybase Adaptive Server Enterprise
構文
AppName = 'application_name'
デフ ォル ト 値
Microsoft SQL Server AppName パ ラ メ ー タ のデ フ ォ ル ト 値は あ り ま
せん。 値を指定 し ない限 り 、 AppName パ ラ メ ー タ は設定 さ れ ま せん。
Adaptive Server Enterprise
CS_APPNAME 接続プロ パティ に PowerBuilder
が設定さ れま す。
AppName = 'PowerBuilder'
解説
SQL Server デー タ ベース SQL Server アプ リ ケーシ ョ ン ご と に異な る
AppName 値を指定す る と 効果的です。
SQL Server 管理者は、 MASTER.DBO.SYSPROCESSES テーブル を調べ
る こ と に よ っ て、 デー タ ベース サーバ上で ど の よ う な ア プ リ ケーシ ョ
ン が稼働 し てい る のか を判断で き ま す。 AppName パ ラ メ ー タ に指定す
る 値は、 MASTER.DBO.SYSPROCESSES テーブルの program_name カ
ラ ム に表示 さ れ る ため、 アプ リ ケーシ ョ ン を簡単に識別で き ま す。
例
例1
•
アプ リ ケーシ ョ ン名を Test に設定す る には以下の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ネ ッ ト ワ ー ク ］ タ ブ の ［ア プ リ ケーシ ョ ン名］ ボ ッ ク ス
で、 以下の入力を行い ま す。
デー タ ベース プ ロ フ ァ イル
Test
•
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "AppName = 'Test'"
1 つの DBParm 文に AppName パ ラ メ ー タ と Host パ ラ メ ー タ を指
定す る こ と に よ っ て、 ア プ リ ケーシ ョ ン名 と ホ ス ト 名の両方が指定で
き ま す。 ア プ リ ケーシ ョ ン名を Sales に、 ホ ス ト 名を Fran に設定す る
には以下の よ う に し ま す。
例2
6
PowerBuilder
第1章
DBParm パ ラ メ ー タ
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ネ ッ ト ワ ー ク ］ タ ブで、 ［アプ リ ケーシ ョ ン名］ ボ ッ ク ス
に Sales、 ［ ワー ク ス テーシ ョ ン名］ ボ ッ ク ス に Fran と 入力 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "AppName = 'Sales',Host = 'Fran'"
関連項目
Host （現在 SYC Sybase Adaptive Server Enterprise でのみ有効）
Async
機能
PowerBuilder におい て、 デー タ ベー ス に対す る 非同期処理を有効に し
ま す。 た と えば、 デー タ ウ ィ ン ド ウ オブジ ェ ク ト に RetrieveRow イ ベ
ン ト を指定 し た場合、 現行のデー タ ベー ス 検索処理が ま だ終了 し てい
な く て も 、 その処理を キ ャ ン セル し た り 、 同 じ デー タ ベー ス 接続を使
用 し ない別の （デー タ ベース と は無関係の） 処理を起動 し ま す。 ま た、
検索処理が さ れてい る 間に、 別の Windows プ ロ セ ス に切 り 替え る こ と
も で き ま す。
デフ ォ ル ト では、 PowerBuilder は同期処理を し ま す。
対象
IN9 Informix
JDB JDBC
MSS Microsoft SQL Server
ODBC（ ド ラ イ バお よ びバ ッ ク エ ン ド DBMS がサポー ト し てい る 場合）
O73 Oracle 7.3
O84 Oracle 8.x お よ び Oracle8i （8.1.5 以降のデー タ ベース 接続のみ）
O90 Oracle9i
SYC Sybase Adaptive Server Enterprise
構文
Async = value
パラ メ ー タ
value
デ フ ォル ト 値
接続 リ フ ァ レ ン ス
説明
同期処理ま たは非同期処理を指定す る 値。 以下のいずれか
の値を指定 し ま す。
• 0 （デフ ォ ル ト ） 同期処理
• 1 非同期処理
Async = 0
7
Async
解説
PowerBuilder におけ る 非同期処理を有効にす る と 、 結果を返すのに時
間が か か る 複雑な SQL 文 を 実行す る と き に効果的です。 Async パ ラ
メ ー タ が 1 に設定 さ れてい る 場合、 SQL 文の実行中に以下の操作がで
き ま す。
•
別の ウ ィ ン ド ウ での処理
•
最初の行のデー タ を取得す る 前の、 SQL 文のキ ャ ン セル
Async を設定す る タ イ ミ ン グ PowerBuilder ス ク リ プ ト で デー タ ベー
ス と 通信 し て い る 場合は、 ト ラ ン ザ ク シ ョ ン オ ブ ジ ェ ク ト がデー タ
ベース と 接続す る 前 と 後のど ち ら で も 、 Async 値 を リ セ ッ ト で き ま す。
デー タ 取得に伴 う 処理 デー タ ウ ィ ン ド ウ オ ブ ジ ェ ク ト ま た は レ
ポー ト の中でデー タ の取得をす る と 、以下の順番で処理が行われ ま す。
1
デー タ ベース サーバが SQL 文を コ ンパ イ ル し 、 実行 し ま す。
2
PowerBuilder が最初の行のデー タ を取得 （フ ェ ッ チ） し ま す。
3
PowerBuilder が以降の各行のデー タ を取得 し ま す。
最初の行が取得 さ れ る 前にす る 操作 サーバ が SQL 文 を コ ン パ イ ル
し 、 実行 し てい る 間で、 かつ、 PowerBuilder が最初の行のデー タ を取
得す る 前に、 非同期処理を有効にす る ためには、 以下の操作を 両方 と
も 実行 し てお き ま す （ こ れに よ っ て、 最初の行のデー タ が取得 さ れ る
前に、 こ の処理を キ ャ ン セルで き ま す）。
•
データ ウ ィ ン ド ウ オブジェ ク ト ま たはレ ポート に対し て RetrieveRow
イ ベ ン ト を指定 し ま す （ コ ー ド には コ メ ン ト だけ の指定 も で き ま
す）。
•
Async DBParm パ ラ メ ー タ を 1 に設定 し ま す。
最初の行が取得 さ れた後です る 操作 最初の行のデー タ が取得 さ れた
後、 以降の行を フ ェ ッ チす る 間に、 非同期処理を有効にす る ためには、
以下の操作を実行 し てお き ま す。
•
データ ウ ィ ン ド ウ オブジェ ク ト ま たはレ ポート に対し て RetrieveRow
イ ベン ト を指定 し ま す。
最初の行が取得 さ れた後は、Async DBParm パ ラ メ ー タ を 1 に設定 し な
く て も 、 PowerBuilder は非同期処理を し ま す。 し たが っ て、 最初の行
のデー タ が取得 さ れた後はいつで も 、 現行の操作を キ ャ ン セルで き ま
す。 し たがっ て、 最初の行のデー タ が取得 さ れた後、 Async DBParm パ
ラ メ ー タ を設定 し て も 意味はあ り ま せん。
例
8
例1
非同期処理を有効にす る には以下の よ う に し ま す。
PowerBuilder
第1章
DBParm パ ラ メ ー タ
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ ト ラ ン ザ ク シ ョ ン］ タ ブの ［非同期］ チ ェ ッ ク ボ ッ ク ス
を オ ン に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に次の よ う に入力 し ま す。
SQLCA.dbParm = "Async = 1"
1 つの DBParm 文に Async パ ラ メ ー タ と DBGetTime パ ラ メ ー タ
の両方を指定で き ま す。 DBGetTime パ ラ メ ー タ は、 デー タ ウ ィ ン ド ウ
オブジ ェ ク ト ま たは レ ポー ト の中で行を検索す る と き の、 DBMS か ら
の応答待ち時間を秒単位に指定 し ま す。非同期処理を有効に し た上で、
DBGetTime パ ラ メ ー タ を 20 秒に設定す る には以下の よ う に し ま す。
例2
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ ト ラ ン ザ ク シ ョ ン］ タ ブで、 ［非同期］ チ ェ ッ ク ボ ッ ク ス
を オ ン に し 、 ［処理待ち時間］ ボ ッ ク ス に 20 と 入力 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "Async = 1, DBGetTime = 20"
関連項目
DBGetTime
AtAtIdentity
機能
Microsoft SQL Server デー タ ベー ス イ ン タ フ ェ ー ス で デー タ ベー ス
テーブル内の新 し い行の識別値を取得す る と き に使用す る 構文を指定
し ま す。
IDENTITY カ ラ ム を 含む Microsoft SQL Server テーブル内にデータ ウ ィ
ン ド ウ 更新要求によ っ て新し い行が挿入さ れる と き 、データ ウ ィ ン ド ウ
エン ジ ン は新し く 挿入さ れた 行の識別値を 取得する た めに PBMSS90J
を 呼び出し ま す。 AtAtIdentity DBParm では、 こ の要求の実装方法 を定
義で き ま す。
対象
MSS Microsoft SQL Server
構文
AtAtIdentity = value
接続 リ フ ァ レ ン ス
9
AtAtIdentity
パラ メ ー タ
value
説明
新 し く 挿入 さ れた行の識別値 を取得す る ための構文 を指定
し ます。 以下のいずれかの値 を指定 し ます。
• 0 （デフ ォ ル ト ） 構文 SELECT MAX （IDENTCOL） FROM <
テーブル名 > を使用 し ます。
• 1 構文 SELECT @@identity を使用 し ます。
1 の代わ り に TRUE ま たは Yes、 0 の代わ り に FALSE ま た
は No を指定で き ます。
デフ ォル ト 値
AtAtIdentity = 0
解説
デフ ォ ル ト で、 PBMSS90J は SELECT MAX （IDENTCOL） FROM < テーブル名
> を発行 し ま す。 こ の場合、 2 人のユーザが同時に同 じ テーブル を更新
し な い限 り 、 正 し い結果が得 ら れ ま す。 ア プ リ ケーシ ョ ン で同 じ テー
ブルに複数の同時更新を行 う 場合、 AtAtIdentity = 1 を設定 し ま す。
AtAtIdentity が設定 さ れてい る 場合、 PBMSS90J は新 し く 挿入 さ れた行
の IDENTITY カ ラ ム値を取得す る ために SELECT @@identity を発行 し
ま す。 こ の要求が成功す る と 、同時更新の発生の有無にかかわ ら ず、適
切な識別値が得 ら れ ま す。 し か し 、 IDENTITY カ ラ ム を含むテーブル
に挿入 ト リ ガが関連付け ら れてい る 場合、AtAtIdentity=1 は機能 し ない
場合があ り ま す。 挿入 ト リ ガが @@identity シ ス テ ム変数を 0 に リ セ ッ
ト す る よ う な別のデー タ ベー ス 活動 （活動 ロ グ テーブルに行を挿入す
る 場合な ど ） を実行す る こ と も 考え ら れ ま す。 し たが っ て、 新 し く 挿
入 さ れた識別値を得 る ための最善の方法を ケー ス バ イ ケー ス で決定す
る 必要があ り ま す。 AtAtIdentity は動的な DBParm で あ る ので、 アプ リ
ケーシ ョ ン内でいつで も 設定お よ び リ セ ッ ト で き ま す。
例
新 し く 挿入 さ れた行の識別値を 取得す る た めの構文を 指定す る には、
以下の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［構文］ タ ブの ［IDENTITY カ ラ ム値の取得時に @@identity
を使用］ チ ェ ッ ク ボ ッ ク ス を オ ン に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "AtAtIdentity = '1'"
10
PowerBuilder
第1章
DBParm パ ラ メ ー タ
Block （ODBC、 OLE DB、 Oracle）
機能
Block を サポー ト す る イ ン タ フ ェ ース の場合に、デー タ ベー ス と 接続す
る と き にカー ソ ルブ ロ ッ ク フ ァ ク タ を指定 し ま す。 ブ ロ ッ ク フ ァ ク タ
は、 デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト がデー タ ベース か ら 一度に フ ェ ッ
チで き る 行数を決定 し ま す。
Block DBParm パ ラ メ ー タ を使用す る と 、 PowerBuilder か ら デー タ ベー
ス にア ク セ ス す る と き のパフ ォーマ ン ス が向上 し ま す。
対象
ODBC（ ド ラ イ バお よ びバ ッ ク エ ン ド DBMS がサポー ト し てい る 場合）
OLE DB
O73 Oracle 7.3
O84 Oracle 8.x お よ び Oracle8i
O90 Oracle9i
構文
Block = blocking_factor
パラ メ ー タ
blocking_factor
説明
デー タ ウ ィ ン ド ウ オ ブ ジ ェ ク ト がデー タ ベー ス か ら 一
度に フ ェ ッ チす る 行数。 1 ～ 1000 の範囲の値を指定 し ま
す。
ブ ロ ッ ク フ ェ ッ チ を無効にす る には、 Block パ ラ メ ー タ
に 1 を指定 し ます。
デ フ ォル ト 値
以下の表に示す よ う に、Block パ ラ メ ー タ のデフ ォ ル ト 値は、 ア ク セ ス
し てい る DBMS に よ っ て異な り ま す。
DBMS
Block パ ラ メ ー タ のデ フ ォ ル ト 値
ODBC
大部分のデー タ ウ ィ ン ド ウ オブジ ェ ク ト の場合、 Block パ ラ メ ー
タ のデフ ォ ル ト 値は以下の と お り です。 最大値は 32K / カ ラ ム で
す。
Block = 1000
デー タ ウ ィ ン ド ウ オブジ ェ ク ト が、必要な行だけ をデー タ ベー ス
か ら 取 得 す る こ と を 指 定 し た 場 合 （Retrieve.AsNeeded プ ロ パ
テ ィ ）、 Block パ ラ メ ー タ のデフ ォ ル ト 値は以下の と お り です。 な
お、 最大値は 32K / カ ラ ム です。
Block = 100
接続 リ フ ァ レ ン ス
OLE DB
ブ ロ ッ ク フ ァ ク タ は 1 に設定 さ れ ます。
Oracle
一度に フ ェ ッ チで き る 最大行数が ブ ロ ッ ク フ ァ ク タ に設定 さ れ
ます。 なお、 最大値は 32K / カ ラ ム です。
11
Block （ODBC、 OLE DB、 Oracle）
デ フ ォ ル ト ブ ロ ッ ク フ ァ ク タ の使用
Block パ ラ メ ー タ に対 し て、デフ ォ ル ト 以外の値を設定す る 必要は あ り
ま せん。 ほ と ん ど の場合、 PowerBuilder の使用す る デフ ォ ル ト ブ ロ ッ
ク フ ァ ク タ で十分な結果が得 ら れ ま す。
解説
ODBC デー タ ソ ー ス の要件 ODBC デー タ ソ ー ス で Block DBParm パ
ラ メ ー タ を使用す る には、 ODBC ド ラ イ バが以下の要件を満た し てい
る 必要があ り ま す。
•
ODBC Version 2.0 以上に準拠 し てい る
•
SQLExtendedFetch API 呼び出 し を サポー ト し てい る
PowerBuilder で提供 さ れ る Adaptive Server® Anywhere ODBC ド ラ イ バ
は、 こ の要件を両方 と も 満た し てい ま す。
使用 し てい る ODBC ド ラ イ バが要件を満た し てい る か ど う かについて
は、 ド ラ イ バ付属のマニ ュ アル を参照 し て く だ さ い。
ODBC デー タ ソ ー ス の Block 値の決定 PowerBuilder は以下の順序で
検索を し 、 ODBC デー タ ソ ース の Block 値を決定 し ま す。
1
PowerBuilder 初期設定フ ァ イ ル内のデー タ ベース プ ロ フ ァ イ ルに
対応す る セ ク シ ョ ン （開発環境の場合）。 ま たは、 ト ラ ン ザ ク シ ョ
ン オブ ジ ェ ク ト の DBParm プ ロ パテ ィ の値 （PowerBuilder アプ リ
ケーシ ョ ン の場合）。
2
使用 し てい る ODBC ド ラ イ バに対応す る 、PBODB90 初期設定フ ァ
イ ルの中のセ ク シ ョ ン
ど ち ら の場所に も Block 値の指定が見つか ら ない場合は、 ア ク セ ス し
てい る DBMS に対応す る Block パ ラ メ ー タ のデフ ォ ル ト 値が使用 さ れ
ま す。
ブ ロ ッ ク フ ェ ッ チの無効化 ODBC デ ー タ ソ ー ス や Oracle デ ー タ
ベー ス に対す る ブ ロ ッ ク フ ェ ッ チ を無効にす る には、 Block パ ラ メ ー
タ に 1 を設定 し ま す。
例
12
デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト のブ ロ ッ ク フ ァ ク タ を 50 行に設定す
る には以下の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ ト ラ ン ザ ク シ ョ ン］ タ ブ の ［検索ブ ロ ッ ク 化係数］ ボ ッ
ク ス に 50 と 入力 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
PowerBuilder
第1章
DBParm パ ラ メ ー タ
SQLCA.dbParm = "Block = 50"
Block （Adaptive Server Enterprise）
機能
カ ー ソ ル を 宣言 す る と き に、 Sybase Client Library （CT-Lib） イ ン タ
フ ェ ー ス が使用す る 内部ブ ロ ッ ク フ ァ ク タ を 指定 し ま す。 ブ ロ ッ ク
フ ァ ク タ は、 CT-Lib が物理的なデー タ リ ク エ ス ト をす る と き に、 デー
タ ベー ス か ら 一度に フ ェ ッ チで き る 行数を決定 し ま す。
Sybase System 10.x ま た は System 11.x デ ー タ ベ ー ス と の 接 続 で は、
Block DBParm パ ラ メ ー タ は、 宣言 さ れた カー ソ ルに対 し てだけ適用 さ
れ、 デー タ ウ ィ ン ド ウ オブジ ェ ク ト レ ポー ト には適用 さ れ ま せん。
対象
SYC お よ び SYJ Sybase Adaptive Server Enterprise
構文
Block = blocking_factor
パラ メ ー タ
blocking_factor
デ フ ォル ト 値
例
説明
CT-Lib が物理的なデー タ リ ク エ ス ト をす る と き に、デー
タ ベー ス か ら 一度に フ ェ ッ チす る 行数。 デ フ ォ ル ト ブ
ロ ッ ク フ ァ ク タ は 100 行です。
Block = 100
例1
ブ ロ ッ ク フ ァ ク タ を 1000 行に設定す る には以下の よ う に し ま
す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ ト ラ ン ザ ク シ ョ ン］ タ ブの ［検索ブ ロ ッ ク 化係数］ ボ ッ
ク ス で、 以下の入力を行い ま す。
デー タ ベース プ ロ フ ァ イル
1000
•
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "Block = 1000"
以下の埋め込み SQL 文では、 PowerBuilder ア プ リ ケーシ ョ ン の
ス ク リ プ ト でブ ロ ッ ク フ ァ ク タ を設定 し 、 こ れ を使用 し て カー ソ ルを
宣言す る 方法が示 さ れてい ま す。 以下の ス テー ト メ ン ト は、 ブ ロ ッ ク
フ ァ ク タ を 1000 行に設定 し 、 こ の内部ブ ロ ッ ク フ ァ ク タ を使用す る
カー ソ ル を宣言 し ま す。
例2
SQLCA.dbParm = "Block = 1000"
DECLARE dept_cursor CURSOR FOR
SELECT dept_id, dept_name FROM department
USING SQLCA;
接続 リ フ ァ レ ン ス
13
CacheAuthentication
OPEN dept_cursor;
CacheAuthentication
機能
OLE DB デー タ プ ロ バ イ ダがパ ス ワ ー ド な ど の認証情報を内部キ ャ ッ
シ ュ にキ ャ ッ シ ュ で き る か ど う か を指定 し ま す。
CacheAuthentication を指定す る タ イ ミ ン グ
CacheAuthentication DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ
ベース に接続す る 前に指定 し ま す。
対象
OLE DB
構文
CacheAuthentication = 'value'
パラ メ ー タ
value
説明
OLE DB デー タ プ ロ バ イ ダが認証情報を キ ャ ッ シ ュ で き る か
ど う か を指定 し ま す。 以下のいずれかの値を指定 し ま す。
• True OLE DB デー タ プ ロ バ イ ダが情報を キ ャ ッ シ ュ す る
• False （デ フ ォ ル ト ） OLE DB デー タ プ ロ バ イ ダは情報 を
キ ャ ッ シ ュ し ない
デフ ォル ト 値
CacheAuthentication = 'False'
例
OLE DB デー タ プ ロ バ イ ダが認証情報を キ ャ ッ シ ュ す る よ う にす る に
は以下の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［セキ ュ リ テ ィ ］ タ ブの ［認証のキ ャ ッ シ ュ ］ チ ェ ッ ク ボ ッ
ク ス をオ ン に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "CacheAuthentication='True'"
関連項目
14
IntegratedSecurity
DataLink
PowerBuilder
第1章
DBParm パ ラ メ ー タ
CacheName
機能
PowerBuilder が名前で EAServer 接続キ ャ ッ シ ュ を指定で き る よ う に し
ま す。 こ の DBParm パ ラ メ ー タ は、 PowerBuilder カ ス タ ム ク ラ ス ユー
ザ オブ ジ ェ ク ト が EAServer コ ン ポーネ ン ト と し て配布 さ れ る 場合だ
け使用 し ま す。
対象
JDB JDBC
ODBC
O73 Oracle 7.3
O84 Oracle 8.x と 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 で 「名前で キ ャ ッ シ ュ にア ク セ ス で き る 」 オプシ ョ ンが有効
に な っ て い る 場合は、 接続 キ ャ ッ シ ュ 名だ け を 入力 し て接続 キ ャ ッ
シ ュ を指定 し ま す。
PowerBuilder を使用 し て EAServer コ ン ポーネ ン ト を作成す る 方法につ
いては、 『ア プ リ ケーシ ョ ン テ ク ニ ッ ク 』 マ ニ ュ アル を 参照 し て く だ
さ い。
こ のパ ラ メ ー タ は、 動的に設定す る こ と がで き ま せん。 接続の確立時
に設定 さ れた値は、 接続が切断す る ま で有効です。
接続 リ フ ァ レ ン ス
15
CallEscape
例
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'
解説
設定が必要な場合 使用 し てい る ODBC ド ラ イ バが、 CallEscape 構文
で は な く 、 ネ イ テ ィ ブ （ ド ラ イ バ固有の） SQL 構文の ス ト ア ド プ ロ
シージ ャ コ ールを受け取 る 場合は、 CallEscape を No に設定 し ま す。
使用 し てい る ODBC ド ラ イ バの ス ト ア ド プ ロ シージ ャ コ ールについ
ては、 各ベン ダのマニ ュ アルを参照 し て く だ さ い。
16
PowerBuilder
第1章
DBParm パ ラ メ ー タ
レ ベル 2 以上の ODBC ド ラ イ バ要件 CallEscape DBParm パ ラ メ ー タ
を使 う ためには、 ODBC ド ラ イ バが、 レベル 2 以上の API 合致要件を
満た し てい る 必要があ り ま す。 コ ア ま たは レベル 11 の API 合致要件
を満たす ODBC ド ラ イ バを使っ てい る 場合は、 CallEscape には影響が
あ り ま せん。
ス ト ア ド プ ロ シージ ャ CallEscape 構文の例 以 下 の 例 は、 CallEscape
構文を使用す る sp_test と い う ス ト ア ド プ ロ シージ ャ コ ールを説明 し
て い ま す。
{call sp_test(1,1)}
例
ODBC ド ラ イ バに コ マ ン ド を送 る 前に、 ス ト ア ド プ ロ シージ ャ コ ール
を ド ラ イ バ固有のネ イ テ ィ ブ SQL 構文に変換 し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の［構文］ タ ブの［エ ス ケープ呼び出 し 構文を使用す る ］ チ ェ ッ
ク ボ ッ ク ス を オ フ に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に次の よ う に入力 し ま す。
SQLCA.DBParm = "CallEscape = 'No'"
CharSet
機能
Sybase Adaptive Server Enterprise を介 し て ア ク セ スす る デー タ ベー ス に
接続す る と き に、 Sybase Open Client™ ソ フ ト ウ ェ ア が使用す る 文字
セ ッ ト を指定 し ま す。
CharSet を指定す る タ イ ミ ン グ
CharSet DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー ス に接続
す る 前に指定 し ま す。
対象
SYC Sybase Adaptive Server Enterprise
構文
CharSet = 'character_set'
デ フ ォル ト 値
なし
解説
CharSet パ ラ メ ー タ に値を指定す る と 、 PowerBuilder は以下の処理を し
ま す。
接続 リ フ ァ レ ン ス
•
こ の接続に対 し て CS_LOCALE 構造体を割 り 当て ま す。
•
指定す る 文字セ ッ ト を CS_SYB_CHARSET 値に設定 し ま す。
17
CnnPool
•
SQL Server CS_LOC_PROP 接続プ ロ パテ ィ に、 新 し い ロ ケール情
報を設定 し ま す。
Locale DBParm 設定の無効化 Locale DBParm パ ラ メ ー タ は、使用す る
言語や文字セ ッ ト を 指定 し ま す。 こ の Locale DBParm パ ラ メ ー タ がす
でに設定 さ れてい る 場合、 CharSet DBParm パ ラ メ ー タ に新 し い値を指
定 し 、 デー タ ベー ス と 再接続す る こ と に よ っ て、 文字セ ッ ト の設定を
変更で き ま す。
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
•
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "CharSet = 'iso_1'"
関連項目
Language
Locale
CnnPool
機能
Oracle が接続を プールす る か ど う か を指定 し ま す。 Oracle の接続プー
ルはい く つかのセ ッ シ ョ ン に ま たが り 、 Oracle Call Interface （OCI） に
よ っ て管理 さ れ る 物理的な再利用可能な グループです。 CnnPool パ ラ
メ ー タ は、 EAServer へ配布 さ れ る PowerBuilder コ ン ポーネ ン ト のため
には使用で き ま せん。 ま た、 外部ユーザは、 接続プールに参加す る こ
と はで き ま せん。 デフ ォ ル ト では、 接続プールは使用 し ま せん。
対象
O90 Oracle9i
18
PowerBuilder
第1章
構文
DBParm パ ラ メ ー タ
CnnPool = 'value'
パラ メ ー タ
value
説明
以下のいずれかの値を指定 し ます。
• Yes
• No （デフ ォ ル ト ）
デ フ ォル ト 値
No
解説
CnnPool='Yes' の場合、 Oracle9i ク ラ イ ア ン ト は接続プールを作成 し 、
Oracle 8、 Oracle8i、 お よ び Oracle9i サーバへの接続が可能にな り ま す。
プールには Oracle サーバへの物理的な接続情報が含ま れていて、 OCI
に よ っ て管理 さ れてい ま す。 プールは、 PowerBuilder が終了す る ま で、
ま たは OCI.dll がア ン ロ ー ド さ れ る ま で保持 さ れ ま す。
PowerBuilder はサービ ス 名で識別 し て、異な る 10 個の Oracle サーバへ
同時に接続す る こ と が可能です。 1 プールについて 20 接続 ま で可能で
す。 各プールは Oracle9i ク ラ イ ア ン ト に よ っ て作成 さ れ、 Oracle8 と
Oracle8i サーバへの接続 を含む こ と も 可能です。 一度接続プールが作
成 さ れ る と 、 PowerBuilder が終了す る ま で、 ま た は OCI.DLL が ア ン
ロ ー ド さ れ る ま で、 物理的な接続を保持 し ま す。
例
接続プールを使用す る 場合 :
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス で ［接続］ タ ブの以下の フ ィ ール ド に値を入力 し て く だ さ い。
デー タ ベース プ ロ フ ァ イル
•
プ ロ フ ァ イ ル名 － 例 ： 08i-pool
•
サーバ － Oracle Net で作成 さ れたネ ッ ト サービ ス 名を フ ルで
指定 し ま す。 例 ： adcora8i.sybase.com
•
ロ グ イ ン ID － 例 ： scott
•
パス ワー ド
•
ユーザ権限 － ド ロ ッ プダ ウ ン メ ニ ュ ーか ら 項目を選択 し ま
す。 例 ： Normal
［接続プールの使用］ を選択 し てい る こ と を確認 し て く だ さ い。
•
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.DBMS = "O90 Oracle9i (9.0.1)"
SQLCA.LogPass = <password>
SQLCA.ServerName = "server_name"
SQLCA.LogId = "login"
接続 リ フ ァ レ ン ス
19
CommitOnDisconnect
SQLCA.AutoCommit = False
SQLCA.DBParm = "CnnPool='Yes'"
password、 server_name、 お よ び login には、 接続先に適 し た値を入
れて く だ さ い。
CommitOnDisconnect
機能
デー タ ソ ー ス か ら 接続を解除す る 前に、 コ ミ ッ ト さ れていないデー タ
ベー ス の更新をすべて コ ミ ッ ト （デフ ォ ル ト の処理） す る か、 ま たは
ロ ールバ ッ ク す る か を指定 し ま す。
CommitOnDisconnect を指定する タ イ ミ ン グ
CommitOnDisconnect DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ
ベース に接続す る 前に指定 し ま す。
対象
SYJ 以外のすべてのデー タ ベー ス イ ン タ フ ェー ス
構文
CommitOnDisconnect = 'value'
パラ メ ー タ
value
説明
デー タ ソ ー ス か ら 接続を解除す る 前に、 コ ミ ッ ト さ れてい
ないデー タ ベー ス の更新 をすべて コ ミ ッ ト す る か、 ロ ール
バ ッ ク す る か を 指定 し ます。 以下のいずれかの値 を指定 し
ます。
• Yes （デ フ ォ ル ト ） ア プリ ケ ーショ ン を 終了し たと き 、ま
たは PowerBuilder ス ク リ プ ト で明示的に DISCONNECT
文が 発行 さ れ た と き に、 コ ミ ッ ト さ れ て い な い デー タ
ベー ス の更新がすべて コ ミ ッ ト さ れます。
• No PowerBuilder アプ リ ケーシ ョ ン を終了 し た と き、 ま
たは PowerBuilder ス ク リ プ ト で明示的に DISCONNECT
文が 発行 さ れ た と き に、 コ ミ ッ ト さ れ て い な い デー タ
ベー ス の更新 がすべ て ロ ール バ ッ ク さ れ ま す。 こ の 場
合、 デ ー タ ベ ー ス か ら 接 続 を 解 除 す る と き に、
PowerBuilder は更新内容を自動的に コ ミ ッ ト し ません。
デフ ォル ト 値
CommitOnDisconnect = 'Yes'
解説
CommitOnDisconnect は、 デー タ ベース か ら 接続を解除す る と き に、 コ
ミ ッ ト さ れていないデー タ ベー ス の更新が、 自動的に コ ミ ッ ト さ れ る
の では な く 、 ロ ールバ ッ ク さ れ る よ う に し た い場合に No に設定 し ま
す。
20
PowerBuilder
第1章
例
DBParm パ ラ メ ー タ
デー タ ベース か ら 接続を解除す る と き に、 コ ミ ッ ト さ れていないデー
タ ベース の更新が自動的に コ ミ ッ ト さ れ る のではな く 、 ロ ールバ ッ ク
さ れ る よ う にす る には、 以下の よ う に し て CommitOnDisconnect を No
に設定 し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［接続］ タ ブ の ［接続終了時に コ ミ ッ ト ］ チ ェ ッ ク ボ ッ ク
ス を オ フ に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に次の よ う に入力 し ま す。
SQLCA.DBParm = "CommitOnDisconnect = 'No'"
ConnectAs
機能
ユーザが SYSOPER ま たは SYSDBA のシ ス テ ム権限で Oracle サーバに
接続す る こ と を許可 し ま す。
対象
O90 Oracle9i
構文
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 ス キーマ を使用 し ま す。
接続 リ フ ァ レ ン ス
21
ConnectOption
CnnPool = 'Yes' と 設定 し た状態では使用 し ない で く だ さ い。
接続プールは、 こ のパ ラ メ ー タ と 一緒に使用す る こ と は で き ま せん。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク ス の ［接続プールの使用］ ま
たは CnnPool を 'Yes' に設定 し ないで く だ さ い。
例
ユーザ ID に関連付け ら れてい る ス キーマの代わ り に、SYS ス キーマ を
使用す る には以下の よ う に し ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［接続］ ページで、 ［接続モー ド ］ ド ロ ッ プダ ウ ン リ ス ト の
「SYSDBA」 を 選択 し 、 ［接続プールの使用］ を選択 し て い る こ と
を確認 し て く だ さ い。
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
デー タ ベース プ ロ フ ァ イル
PowerBuilder
ケーシ ョ ン ス ク リ プ ト に、 次の よ う に入力 し ま す。
アプ リ
SQLCA.DBParm = "ConnectAs='SYSDBA'"
ConnectOption
機能
PowerBuilder か ら ODBC デー タ ソ ース に接続す る と き に、 ド ラ イ バ固
有の接続オプ シ ョ ン を設定 し ま す。 オプ シ ョ ン で指定す る 内容は以下
の と お り です。
•
ODBC ド ラ イ バが接続の追加情報を求め る 方法
•
Microsoft SQL Server 接続に対す る セキ ュ リ テ ィ の種類
•
ODBC ド ラ イ バ マネージ ャ ト レース のオ ン / オ フ と 、 使用す る ト
レース フ ァ イ ル
•
SQLTransact 呼び出 し に伴 う カー ソ ルの動作。 カー ソ ルを閉 じ る
か、 開いた ま ま にす る か を指定
•
SQLPrepare 呼び出 し に対す る テ ン ポ ラ リ ス ト ア ド プ ロ シージ ャ
の処理
一部の ConnectOption パ ラ メ ー タ は、 すべての ODBC ド ラ イ バに適用
さ れ ま すが、 それ以外のパ ラ メ ー タ は特定の ODBC ド ラ イ バだけに適
用 さ れ ま す。
各 ConnectOption パ ラ メ ー タ の内容 と 、 ど の ODBC ド ラ イ バで使用で
き る かについては、 以下の 「構文」 の中の一覧表を参照 し て く だ さ い。
22
PowerBuilder
第1章
DBParm パ ラ メ ー タ
ConnectOption を指定する タ イ ミ ン グ
ConnectOption パ ラ メ ー タ は、 PowerBuilder か ら 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 ド ラ イ
バ と パ ラ メ ー タ の目的や、 パ ラ メ ー タ に指定で き る 値を示 し ま す。
接続 リ フ ァ レ ン ス
23
ConnectOption
パラ メ ー タ
SQL_DRIVER_CONNECT
24
説明
ド ラ イバ SQLDriverConnect API 呼び出 し を サポー ト す る す
べての ODBC ド ラ イ バ。
目的 ODBC デー タ ソ ー ス に接続す る と き に、ODBC ド ラ イ
バが接続の追加情報 （ユーザ ID やパ ス ワ ー ド な ど ） を求め
る 方法を指定 し ます。
値 以下のいずれかの値を指定 し ます。
•
SQL_DRIVER_COMPLETE
（デ フ ォ ル ト ） 接続文字列の情報が正確で十分 な場合、
ド ラ イ バは指定 さ れたデー タ ソ ー ス に接続 し ま す。 一
方、 情報が正確でなか っ た り 、 足 り ない場合、 ド ラ イ バ
は 1 つ以上の ダ イ ア ロ グ ボ ッ ク ス を表示 し て、接続に必
要な情報の入力 を求め ま す。 こ の情報が入力 さ れ る と 、
ド ラ イ バは指定 さ れたデー タ ソ ー ス に接続 し ま す。
•
SQL_DRIVER_COMPLETE_REQUIRED
ド ラ イ バは、 SQL_DRIVER_COMPLETE が設定 さ れ た
場合 と 同 じ 動作を し ます。 さ ら に、 デー タ ソ ー ス に接続
す る のに必要で な い情報に対す る コ ン ト ロ ール を 無効
に し ま す。
•
SQL_DRIVER_PROMPT
ド ラ イ バは、 1 つ以上の ダ イ ア ロ グ ボ ッ ク ス を 表示 し
て、 接続に必要な情報の入力を求め ます。 こ の後、 指定
さ れたデー タ ソ ー ス に接続 し 、 ダ イ ア ロ グ ボ ッ ク ス に
指定 さ れた情報を基に接続文字列を作成 し ます。
•
SQL_DRIVER_NOPROMPT
接続文字列の情報が正確で十分な場合、ド ラ イ バは指定
さ れたデー タ ソ ース に接続 し ます。 一方、 情報が正確で
なか っ た り 、 足 り ない場合、 ド ラ イ バはエ ラ ーを返 し ま
す。
PowerBuilder
第1章
パラ メ ー タ
SQL_INTEGRATED_ SECURITY
SQL_OPT_TRACE
DBParm パ ラ メ ー タ
説明
ド ラ イ バ 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 におけ る セ キ ュ リ テ ィ メ カ ニズ ム につ
いては、DBParm パ ラ メ ー タ につい ての Secure を参照 し て く
だ さ い。
ド ラ イ バ すべての ODBC ド ラ イ バ。
目的 PowerBuilder の 中 で ODBC ド ラ イ バ マ ネ ー ジ ャ ト
レ ー ス を オ ン ま たはオ フ に し て、 ODBC デー タ ソ ー ス と の
接続につい て ト ラ ブル シ ュ ーテ ィ ン グ を し ま す。 ODBC ド
ラ イ バ マネージ ャ ト レ ース は、 ODBC デー タ ソ ー ス に接続
す る と き に、PowerBuilder の ODBC API 関数呼び出 し につい
て、 詳細な情報を提供 し ます。
値 以下のいずれかの値 を指定 し ます。
•
SQL_OPT_TRACE_OFF
（デフ ォ ル ト ）ODBC ド ラ イ バ マネージ ャ ト レー ス を オ
フ に し ます。
•
SQL_OPT_TRACE_ON
ド ラ イ バ マネージ ャ ト レー ス を オ ン に し ます。
ODBC ド ラ イ バ マネージ ャ ト レー ス を使用す る 手順につい
ては、 『デー タ ベー ス と の接続』 マニ ュ ア ル を参照 し て く だ
さ い。
接続 リ フ ァ レ ン ス
25
ConnectOption
パラ メ ー タ
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
26
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）
が開放 さ れた と き に明示的に削除 し ま す。
PowerBuilder
第1章
DBParm パ ラ メ ー タ
デ フ ォル ト 値
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 SQL Server ODBC ド ラ イ バ Microsoft SQL Server ネ イ テ ィ
ブ デー タ ベー ス イ ン タ フ ェ ー ス を 使用 し てデー タ ベー ス に ア ク セ ス
し てい る 場合、 ConnectOption DBParm パ ラ メ ー タ は適用 さ れ ま せん。
こ のパ ラ メ ー タ は、Microsoft ODBC SQL Server ド ラ イ バで、SQL Server
デー タ ベース にア ク セ ス す る と き に限っ て適用 さ れ ま す。
Microsoft SQL Server ODBC ド ラ イ バは、Microsoft 社か ら 入手す る 必要
があ り ま す。 こ の ド ラ イ バは、 PowerBuilder では提供 さ れ ま せん。
例
ConnectOption DBParm パ ラ メ ー タ に、 デフ ォ ル ト 値で ないオプシ ョ ン
を指定す る には以下の よ う に し ま す。
•
•
DB プ ロ フ ァ イ ル設定 - ODBC ダ イ ア ロ
グ ボ ッ ク ス の ［オ プ シ ョ ン］ タ ブ で 値 を 入 力 し ま す。 各
ConnectOption パ ラ メ ー タ は、 次の表に示す よ う に、 こ のダ イ ア ロ
グ ボ ッ ク ス のオプシ ョ ンに対応 し てい ま す。
デー タ ベース プ ロ フ ァ イル
ConnectOption パ ラ メ ー タ
SQL_DRIVER_CONNECT
対応する オ プ シ ョ ン
SQL_INTEGRATED_SECURITY
統合セ キ ュ リ テ ィ
SQL_OPT_TRACE
ODBC API 呼出の ト レ ー ス
SQL_OPT_TRACEFILE
ト レー ス フ ァ イ ル
接続の種類
SQL_PRESERVE_CURSORS
カー ソ ルの保持
SQL_USE_PROCEDURE_FOR_PREPARE
Prepare 時 に 使用す る プ ロ
シージ ャ
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
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:¥PB9¥odbctrce.log;
SQL_PRESERVE_CURSORS,SQL_PC_ON;
SQL_USE_PROCEDURE_FOR_PREPARE,SQL_UP_OFF'"
関連項目
接続 リ フ ァ レ ン ス
Secure
27
ConnectString
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 プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク ス の ［DB 接続構文］
ボ ッ ク ス に コ ピ ー さ れ ま す。こ の処理は、PowerBuilder か ら デー タ ソ ー
ス に接続す る 前に行われ ま す。
28
PowerBuilder
第1章
DBParm パ ラ メ ー タ
し た が っ て、 ODBC デー タ ソ ー ス を 定義す る と き に、 自分自身 で
ConnectString を入力す る 必要は あ り ま せん 。 し か し 、 DB プ ロ フ ァ イ
ル設定 ダ イ ア ロ グボ ッ ク ス で、 ConnectString の値を編集す る こ と が必
要にな る 場合 も あ り ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク ス で編集す る こ と に よ っ て、
必要に応 じ て ConnectString パ ラ メ ー タ の値 を 変更で き ま す。 た と え
ば、 既存の ODBC デー タ ソ ー ス の名前を 変更す る 場合には、 デー タ
ベース プ ロ フ ァ イ ルを編集 し て、 ConnectString に新 し い DSN （デー タ
ソ ース 名） の値を記述 し ま す。
例
こ の例では、デー タ ソ ース 名（DSN=Sales）、ユーザ ID（UID=dba）、
パ ス ワ ー ド （PWD=sql） を指定す る ODBC デー タ ソ ー ス接続文字列が
示 さ れてい ま す。 なお、 接続文字列を構成す る パ ラ メ ー タ は、 セ ミ コ
ロ ン で区切 ら れてい ま す。
例1
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［接続］ タ ブで、 ［デー タ ソ ース ］ ド ロ ッ プダ ウ ン リ ス ト で
「Sales」 を選択 し 、［ユーザ ID］ チ ェ ッ ク ボ ッ ク ス を オ ン に し て dba
と 入力 し 、 ［パ ス ワ ー ド ］ チ ェ ッ ク ボ ッ ク ス を オ ン に し て sql と 入
力 し ま す。
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
デー タ ベース プ ロ フ ァ イル
PowerBuilder
ケーシ ョ ン ス ク リ プ ト に、 次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "ConnectString ='DSN=Sales;UID=dba;
PWD=sql'"
こ の例では、 PB DataDirect Btrieve ODBC ド ラ イ バで ア ク セ ス す
る Btrieve デー タ ソ ー ス に対す る 、接続文字列が示 さ れてい ま す。 接続
文字列は、 DSN と CDB （Scalable SQL デー タ デ ィ ク シ ョ ナ リ を新規に
作成す る こ と を 指定 し ま す） と い う 、 2 つのパ ラ メ ー タ で構成 さ れて
い ま す。 なお、 接続文字列を構成す る パ ラ メ ー タ は、 セ ミ コ ロ ン で区
切 ら れてい ま す。
例2
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［接続］ タ ブ の ［デー タ ソ ー ス ］ ド ロ ッ プ ダ ウ ン リ ス ト か
ら 「Btrieve」 を選択 し 、 ［ ド ラ イ バ固有のパ ラ メ ー タ ］ ボ ッ ク ス で、
以下の入力を行い ま す。
デー タ ベース プ ロ フ ァ イル
CDB=1
•
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で、 以下の入力を行い ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "ConnectString ='DSN=Btrieve;CDB=1'"
接続 リ フ ァ レ ン ス
29
CursorLib
パ ラ メ ー タ の追加
ド ロ ッ プ ダ ウ ン リ ス ト に DSN が表示 さ れてい る 場合、 DSN をパ
ラ メ ー タ に追加す る 必要は あ り ま せん。
CursorLib
機能
ODBC デー タ ソ ー ス と 接続す る と き に、使用す る カー ソ ル ラ イ ブ ラ リ
を指定 し ま す。
対象
ODBC（ ド ラ イ バお よ びバ ッ ク エ ン ド DBMS がサポー ト し てい る 場合）
構文
CursorLib = 'value'
パラ メ ー タ
value
説明
ODBC デー タ ソ ー ス と 接続す る と き に使用す る カー ソ ル
ラ イ ブ ラ リ 。 以下のいずれかの値 を指定 し ます。
• ODBC_Cur_Lib ODBC Version 2.0 以上の カー ソ ル ラ イ
ブ ラ リ を使用 し ます。
• If_Needed 使用 し てい る ODBC ド ラ イ バが カー ソ ル を
サポー ト し ない場合は、 ODBC Version 2.0 以上の カー ソ
ル ラ イ ブ ラ リ を使用 し ます。
• Driver_Cursors （デフ ォ ル ト ） デー タ ソ ー ス のネ イ テ ィ
ブ な カー ソ ル機能を使用 し ます。
デフ ォル ト 値
CursorLib = 'Driver_Cursors'
例
ODBC デー タ ソ ー ス と 接続す る と き に、 ODBC Version 2.0 以上のカー
ソ ル ラ イ ブ ラ リ を使用す る こ と を指定す る には以下の よ う に し ま す。
こ の ス テー ト メ ン ト をデー タ ベー ス プ
ロ フ ァ イ ルに指定す る には、DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ ト ラ ン ザ ク シ ョ ン］ タ ブで ［カー ソ ル］ の ［ ラ イ ブ ラ リ ］
ド ロ ッ プ ダ ウ ン リ ス ト の 「カー ソ ル ラ イ ブ ラ リ 」 を選択 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "CursorLib = 'ODBC_Cur_Lib'"
CursorLock （ODBC）
機能
30
CursorScroll パ ラ メ ー タ と 一緒に使用 さ れ、ODBC デー タ ソ ー ス のカー
ソ ルに対 し て ロ ッ ク オプ シ ョ ン を指定 し ま す。
PowerBuilder
第1章
DBParm パ ラ メ ー タ
CursorLock パ ラ メ ー タ に指定す る 値に よ っ て、 以下の 2 つの観点か ら
カー ソ ル ロ ッ ク を設定で き ま す。
複数のユーザが同一デー タ を同時にア ク セ ス す る こ
と を保証 し ま す。
•
同時ア ク セス
•
衝突の検出方法
複数のユーザが同一デー タ を同時に更新す る と き
に発生す る 衝突を検出 し ま す。
対象
ODBC（ ド ラ イ バお よ びバ ッ ク エ ン ド DBMS がサポー ト し てい る 場合）
構文
CursorLock = 'lock_value'
パラ メ ー タ
lock_value
説明
ODBC カー ソ ルに対 し て使用す る ロ ッ ク の種類。 以下のい
ずれかの値を指定 し ます。
• Lock テーブ ルの 行 を 更新で き る 最下位の ロ ッ ク を 使
用 し ま す。
• Opt 最適化同時実行制御 を使用 し ま す。 つ ま り 、 ほ か
の ユーザに よ る テーブ ル行の更新処理は ロ ッ ク さ れ ま
せん。 衝突を検出す る には、 行のバージ ョ ンや タ イ ム ス
タ ン プ を比較 し ます。
• OptVal 最適化同時実行制御を使用 し ます。 つ ま り 、 ほ
か の ユーザに よ る テーブル行の更新処理は ロ ッ ク さ れ
ま せん。 衝突を検出す る には、 検索 さ れた値 と 以前の値
と を比較 し ます。
• ReadOnly テーブル行は読み出 し 専用で、 行を更新で き
ま せん。
ODBC 標準におけ る ロ ッ ク 値の定義については、 ODBC の
マニ ュ アルを参照 し て く だ さ い。
デ フ ォル ト 値
CursorLock パ ラ メ ー タ に値が指定 さ れ て い な い場合、 ODBC デー タ
ソ ース ド ラ イ バに よ っ て指定 さ れ る カー ソ ル ロ ッ ク の設定が、デフ ォ
ル ト 値 と し て使用 さ れ ま す。
例
ODBC デー タ ソ ー ス にお け る カ ー ソ ル の ス ク ロ ール と ロ ッ ク オ プ
シ ョ ン を設定す る には以下の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ ト ラ ン ザ ク シ ョ ン］ タ ブで、 ［ ス ク ロ ールオプ シ ョ ン］ ド
ロ ッ プダ ウ ン リ ス ト の 「動的 ス ク ロ ール」 、 お よ び ［ ロ ッ ク ］ ド
ロ ッ プ ダ ウ ン リ ス ト の 「Optimistic Using Values」 を選択 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm =
"CursorScroll='Dynamic',CursorLock='OptVal'"
接続 リ フ ァ レ ン ス
31
CursorLock （Microsoft SQL Server)
関連項目
CursorScroll （ODBC）
CursorLock （Microsoft SQL Server)
機能
CursorScroll パ ラ メ ー タ と 一緒に使用 さ れ、Microsoft SQL Server デー タ
ベー ス に ア ク セ ス す る カー ソ ルに対 し て ロ ッ ク オ プ シ ョ ン を 指定 し
ま す。
CursorLock パ ラ メ ー タ に指定す る 値に よ っ て、 以下の 2 つの観点か ら
カー ソ ル ロ ッ ク を設定で き ま す。
複数のユーザが同一デー タ を同時にア ク セ ス す る こ
と を保証 し ま す。
•
同時ア ク セ ス
•
衝突の検出方法
複数のユーザが同一デー タ を同時に更新す る と き
に発生す る 衝突を検出 し ま す。
対象
MSS Microsoft SQL Server
構文
CursorLock = 'lock_value'
パラ メ ー タ
lock_value
説明
SQL Server カー ソ ルに対 し て使用す る ロ ッ ク の種類。 以下
のいずれかの値 を指定 し ます。
•
Lock
•
Opt
•
OptVal
•
ReadOnly
（デフ ォ ル ト ）
こ れ ら の値 を使用 し て同時ア ク セ スや衝突検出 を制御す る
方法につい ては、 以下の 「解説」 の表を参照 し て く だ さ い。
デフ ォル ト 値
CursorLock = 'Opt'
解説
以下の表に、 CursorLock 値に よ る 、 Microsoft SQL Server デー タ ベー ス
におけ る 同時ア ク セ ス と 衝突検出を 制御す る 方法 を簡単に示 し ま す。
詳細については、 SQL Server のマニ ュ アル を参照 し て く だ さ い。
CursorLock
の値
Lock
32
同時実行性の制御
衝突の検出方法
SQL ト ラ ン ザ ク シ ョ ン 内 で
テーブルの行が フ ェ ッ チ さ れ
る と 、 テーブル行を ロ ッ ク し
ま す。 ほかの ユーザは、 ロ ッ
ク さ れた行を更新 し た り 、 読
み込め ま せん。
衝突検出は不要 です。 行 が
ロ ッ ク さ れ、カー ソ ルの所有
者に よ る 更新が保証 さ れ て
い る か ら です。
PowerBuilder
第1章
CursorLock
の値
Opt
例
DBParm パ ラ メ ー タ
同時実行性の制御
衝突の検出方法
テーブルの行を ロ ッ ク し ませ
ん。 ほかのユーザは、 行 を更
新 し た り 、 読み込む こ と がで
き ま す。 こ れを最適化同時実
行制御 と 呼び ます。
タ イ ム ス タ ン プ（利用可能な
場合） が比較 さ れます。 タ イ
ム ス タ ン プ が 利用で き な い
場合は、テーブルのテ キ ス ト
型や イ メ ー ジ 型以外のすべ
ての カ ラ ム の値が保存 さ れ、
以前の値 と 比較 さ れます。
OptVal
テーブルの行を ロ ッ ク し ませ
ん。 ほかのユーザは、 行 を更
新 し た り 、 読み込む こ と がで
き ま す。 こ れを最適化同時実
行制御 と 呼び ます。
タ イ ム ス タ ン プ が利用可能
か ど う かに関 ら ず、検索 さ れ
た値を比較 し ます。
ReadOnly
テ ーブル行は読み出 し 専用
で、 行の更新はで き ません。
行 の更新が禁止 さ れ て い る
ため、 衝突検出は不要です。
SQL Server におけ る カー ソ ルの ス ク ロ ール と ロ ッ ク オプシ ョ ン を設定
す る には以下の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ ト ラ ン ザ ク シ ョ ン］ タ ブで、 ［ ス ク ロ ールオプ シ ョ ン］ ド
ロ ッ プ ダ ウ ン リ ス ト の 「前方ス ク ロ ールのみ」、 お よ び ［ ロ ッ ク ］
ド ロ ッ プ ダ ウ ン リ ス ト の 「Optimistic Using Values」 を選択 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = CursorScroll='Forward',
CursorLock='OptVal'"
関連項目
CursorScroll （Microsoft SQL Server）
CursorScroll （ODBC）
機能
CursorLock パ ラ メ ー タ と 一緒に使用 さ れ、 ODBC デー タ ソ ー ス の カー
ソ ルに対 し て ス ク ロ ールオプ シ ョ ン を指定 し ま す。
カー ソ ルの位置に よ っ て、 SQL 文を実行 し て取得 さ れた結果集合の現
行の位置が示 さ れ ま す。 カー ソ ルを ス ク ロ ールす る こ と に よ っ て、 結
果集合のデー タ か ら デー タ へ 1 行ずつ移動で き ま す。
対象
ODBC（ ド ラ イ バお よ びバ ッ ク エ ン ド DBMS がサポー ト し てい る 場合）
構文
CursorScroll = 'scroll_value'
接続 リ フ ァ レ ン ス
33
CursorScroll （ODBC）
パラ メ ー タ
scroll_value
説明
ODBC カー ソ ルに対 し て使用す る ス ク ロ ールの種類。 以
下のいずれかの値を指定 し ま す。
• Forward カー ソ ルは、 結果集合の中を前方にだけ ス ク
ロ ール し ま す。
• Static 結果集合のデー タ は変更 さ れま せん。
• KeySet カー ソ ルが キーセ ッ ト 駆動 （keyset-driven） で
あ る こ と を指定 し ます。 キーセ ッ ト 駆動な カー ソ ルが
開 く と 、 ド ラ イ バは結果集合全体に対 し て キーを 保存
し ま す。 カー ソ ルは結果集合の中 を ス ク ロ ールす る た
め、 ド ラ イ バは こ のキーセ ッ ト の中のキーを使用 し て、
各行に対す る 現行の値を取得 し ま す。
• Dynamic ド ラ イ バは、行セ ッ ト に指定 さ れた行のキー
だけ を保存 し 、 使用 し ま す。
デフ ォル ト 値
CursorScroll パ ラ メ ー タ に値が指定 さ れ て い な い場合、 ODBC デー タ
ソ ース ド ラ イ バに よ っ て指定 さ れ る カー ソ ル ス ク ロ ールの設定が、デ
フ ォ ル ト 値 と し て使用 さ れ ま す。
解説
結果集合が大 き い場合、 結果集合全体に対 し て キーを保存 し な ければ
な ら ないキーセ ッ ト 駆動な カー ソ ル を使用す る こ と は、 実際的ではあ
り ま せん。 代わ り に、 キーセ ッ ト 内の行数を表す 32 ビ ッ ト の整数値を
指定す る こ と に よ っ て、 複合カー ソ ルを使用す る こ と がで き ま す （以
下の 「例 2」 を参照 し て く だ さ い）。 こ の値は、 通常、 結果集合 よ り も
小 さ な値です。 なお、 デフ ォ ル ト のキーセ ッ ト サ イ ズは 0 です。
複合カー ソ ルは、指定 さ れた キーセ ッ ト 内では KeySet ス ク ロ ールを使
用 し 、 キーセ ッ ト 外では Dynamic ス ク ロ ールを使用 し ま す。
例
ODBC デー タ ソ ース におけ る カー ソ ルの ス ク ロ ール と ロ ッ ク オ
プ シ ョ ン を設定す る には以下の よ う に し ま す。
例1
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ ト ラ ンザ ク シ ョ ン］ タ ブで、 ［ ス ク ロ ールオプ シ ョ ン］ ド
ロ ッ プダ ウ ン リ ス ト の 「動的 ス ク ロ ール」 、 お よ び ［ ロ ッ ク ］ ド
ロ ッ プダ ウ ン リ ス ト の 「Optimistic Using Values」 を選択 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "CursorScroll = 'Dynamic',
CursorLock = 'OptValue'"
以下の例は、 キーセ ッ ト 内の行数を 100 に設定 し ま す。 結果集合
全体は 1000 行あ る も の と し ま す。 カー ソ ルが開 く と 、 結果集合の先頭
の 100 行に対 し て キーが保存 さ れ ま す。続け て、次の 100 キーのブ ロ ッ
ク が取得 さ れ、 結果集合全体が取得 さ れ る ま で処理が続 き ま す。
例2
34
PowerBuilder
第1章
DBParm パ ラ メ ー タ
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ ト ラ ン ザ ク シ ョ ン］ タ ブの ［ス ク ロ ールオプシ ョ ン］ ボ ッ
ク ス に 100 と 入力 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "CursorScroll = 100"
関連項目
CursorLock （ODBC）
CursorScroll （Microsoft SQL Server）
機能
Microsoft SQL Server デー タ ベー ス のカー ソ ルに対 し て、 ス ク ロ ール オ
プ シ ョ ン を 指 定 し ま す。 CursorScroll パ ラ メ ー タ は、 多 く の 場 合、
CursorLock パ ラ メ ー タ と 一緒に使用 さ れ ま す。
カー ソ ルの位置に よ っ て、 SQL 文を実行 し て取得 さ れた結果集合の現
行の位置が示 さ れ ま す。 カー ソ ルを ス ク ロ ールす る こ と に よ っ て、 結
果集合のデー タ か ら デー タ へ 1 行ずつ移動で き ま す。
対象
MSS Microsoft SQL Server
構文
CursorScroll = 'scroll_value'
接続 リ フ ァ レ ン ス
35
CursorScroll （Microsoft SQL Server）
パラ メ ー タ
scroll_value
説明
SQL Server カー ソ ルに対 し て使用す る ス ク ロ ールの種類。
以下のいずれかの値 を指定 し ます。
• Forward カー ソ ルは、 結果集合の中 を前方に だ け ス ク
ロ ール し ます。 結果集合の中の値、 順序、 メ ン バシ ッ プ
は、 カー ソ ルが開い てい る間、 変更 し ません。
• KeySet カー ソ ルが キーセ ッ ト 駆動 （keyset-driven） で
あ る こ と を指定 し ます。 キーセ ッ ト 駆動な カー ソ ルが開
く と 、 ド ラ イ バは結果集合全体に対 し て キー を保存 し ま
す。 カー ソ ルは結果集合の中を ス ク ロ ールす る ため、 ド
ラ イ バは こ の キーセ ッ ト の中のキーを使用 し て、 各行に
対す る 現行の値 を取得 し ます。
• Dynamic （デ フ ォ ル ト ） ド ラ イ バは、 行セ ッ ト に指定 さ
れた行のキーだけ を保存 し 、 使用 し ます。 結果集合の中
の値、 順序、 メ ンバシ ッ プはすべて変更す る 可能性が あ
り ます。
• Insensitive insensitive キーセ ッ ト カー ソ ルは、 カ ー ソ
ルが使用す るデー タ の一時 コ ピー を作成 し ます。 カー ソ
ルに対す る リ ク エ ス ト はすべて、 こ の一時テーブルに対
し て さ れ ます。 こ のため、 コ ピ ーが作成 さ れた後で、 ほ
かのユーザが行に変更 を加え た場合、 insensitive カー ソ
ルは こ の変更を反映 し ません。
insensitive カー ソ ルは、 ほかのユーザに よ る テーブル行
の 更 新 を 禁 止 し て い ま す。 し た が っ て、 CursorScroll
DBParm パ ラ メ ー タ を CursorLock DBParm パ ラ メ ー タ と
一緒に指定す る 場合、 CursorLock の値を ReadOnly に設
定 し て、 更新を禁止 し ます （以下の 「例 2」 を参照 し て
く だ さ い）。
デフ ォル ト 値
CursorScroll = 'Dynamic'
解説
結果集合が大 き い場合、 結果集合全体に対 し て キーを保存 し な ければ
な ら ない、 キーセ ッ ト 駆動な カー ソ ルを使用す る こ と は、 実際的では
あ り ま せん。 代わ り に、 キーセ ッ ト 内の行数を表す 32 ビ ッ ト の整数値
を指定す る こ と に よ っ て、複合カー ソ ル を使用す る こ と がで き ま す（以
下の 「例 3」 を参照 し て く だ さ い）。 こ の値は、 通常、 結果集合 よ り も
小 さ な値です。 なお、 デフ ォ ル ト のキーセ ッ ト サ イ ズは 0 です。
複合カー ソ ルは、指定 さ れた キーセ ッ ト 内では KeySet ス ク ロ ールを使
用 し 、 キーセ ッ ト 外では Dynamic ス ク ロ ールを使用 し ま す。
36
PowerBuilder
第1章
DBParm パ ラ メ ー タ
複合カー ソ ルは、 キーセ ッ ト の行数がマ シ ン の記憶容量を越え る よ う
な場合に効果的です。KeySet ス ク ロ ールを使用す る と 、SQL Server は、
キーセ ッ ト 内のすべての行を保持で き る だけの大 き さ を持つバ ッ フ ァ
を、 マ シ ン上に作成 し よ う と し ま す。 行数がマ シ ン の記憶容量を 超え
る 場合、 メ モ リ 不足を知 ら せ る エ ラ ーが出力 さ れ ま す。
例
SQL Server デー タ ベー ス におけ る カー ソ ルの ス ク ロ ール と ロ ッ
ク オプシ ョ ン を設定す る には以下の よ う に し ま す。
例1
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ ト ラ ン ザ ク シ ョ ン］ タ ブで、 ［ ス ク ロ ールオプ シ ョ ン］ ド
ロ ッ プダ ウ ン リ ス ト の 「動的 ス ク ロ ール」 、 お よ び ［ ロ ッ ク ］ ド
ロ ッ プ ダ ウ ン リ ス ト の 「Optimistic Using Values」 を選択 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = CursorScroll = "'Dynamic',
CursorLock = 'OptVal'"
Microsoft SQL Server デー タ ベース に対 し て、 Insensitive カー ソ ル
ス ク ロ ールや ReadOnly カー ソ ル ロ ッ ク を設定す る には以下の よ う に
し ま す。
例2
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ ト ラ ン ザ ク シ ョ ン］ タ ブで、 ［ ス ク ロ ールオプ シ ョ ン］ ド
ロ ッ プ ダ ウ ン リ ス ト の 「Insensitive Keyset」 、 お よ び ［ ロ ッ ク ］ ド
ロ ッ プ ダ ウ ン リ ス ト の 「Read Only」 を選択 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "CursorScroll = 'Insensitive',
CursorLock = 'ReadOnly'"
以下の ス テ ー ト メ ン ト は、 SQL Server デー タ ベー ス に対 し て、
キーセ ッ ト 内の行数を 100 に設定 し ま す。結果集合全体は 1000 行あ る
も の と し ま す。 カー ソ ルが開 く と 、 結果集合の先頭の 100 行に対 し て
キ ーが保存 さ れ ま す。 続け て、 次の 100 キーのブ ロ ッ ク が取得 さ れ、
結果集合全体が取得 さ れ る ま で処理が続 き ま す。
例3
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ ト ラ ン ザ ク シ ョ ン］ タ ブの ［ス ク ロ ールオプシ ョ ン］ ボ ッ
ク ス で、 以下の入力を行い ま す。
デー タ ベース プ ロ フ ァ イル
100
•
接続 リ フ ァ レ ン ス
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
37
CursorUpdate
SQLCA.dbParm = "CursorScroll = 100"
関連項目
CursorLock （Microsoft SQL Server)
CursorUpdate
機能
Sybase System 10.x ま たは System 11.x デー タ ベー ス のカー ソ ルが、 読
み込み専用 と 更新可能の ど ち ら で宣言 さ れ る か を指定 し ま す。
対象
SYC お よ び SYJ Sybase Adaptive Server Enterprise
構文
CursorUpdate = value
パラ メ ー タ
value
説明
Sybase System 10.x ま たは System 11.x の カー ソ ルが、 読み
込み専用 と 更新可能の ど ち ら で宣言 さ れ る か を指定す る 数
値。 以下のいずれかの値 を指定 し ます。
• 0 （デフ ォ ル ト ） カー ソ ルは読み込み専用で宣言 さ れ
ます。 Sybase Client Library の カー ソ ル宣言で、
CS_READ_ONLY オプシ ョ ン が使用 さ れま す。
• 1 カ ー ソ ル は更新可能 で宣言 さ れ ま す。 Sybase Client
Library の カー ソ ル宣言で、 CS_FOR_UPDATE オプ シ ョ
ン が使用 さ れ ます。 こ のオプシ ョ ンは、 テーブル内の更
新可能なすべての カ ラ ム に適用 さ れ ます。
デフ ォル ト 値
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 の値を リ セ ッ ト で き ま す。
メ イ ン フ レ ームへのゲー ト ウ ェ イ な し 接続で更新可能カー ソ ルを使用
す る 場合は、 カー ソ ルを実行す る 前に Block = 1 を設定す る 必要があ り
ま す。 PowerScript コ ー ド の中で カー ソ ルを閉 じ た ら 、 その後は Block
パ ラ メ ー タ の値をデフ ォ ル ト 値の 100 に戻 し て も か ま い ま せん。
例
Sybase System 10.x ま たは System 11.x のカー ソ ル を更新可能で宣言す
る には以下の よ う に し ま す。
38
PowerBuilder
第1章
DBParm パ ラ メ ー タ
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ ト ラ ン ザ ク シ ョ ン］ タ ブの ［更新可能カー ソ ル］ チ ェ ッ
ク ボ ッ ク ス を オ ンに し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "CursorUpdate = 1"
DataLink
機能
デー タ ソ ー ス に接続す る ために、 OLE DB 接続情報を格納す る フ ァ イ
ル を作成す る か、 既存の フ ァ イ ルを使用す る か を指定 し ま す。
DataLink を指定する タ イ ミ ン グ
DataLink DBParm パ ラ メ ー タ は、PowerBuilder か ら デー タ ベー ス に接続
す る 前に指定 し ま す
対象
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」 を参照 し て く だ さ い。
デー タ リ ン ク フ ァ イルの使用 と DBParm パ ラ メ ー タ の設定
デー タ リ ン ク フ ァ イ ルを使用 し てデー タ ソ ー ス に接続す る 場合、OLE
DB の DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク ス での設定はすべて無
視 さ れ ま す。
接続 リ フ ァ レ ン ス
39
DataSource
例
フ ァ イ ル oledb.udl を使用 し て OLE DB デー タ プ ロ バ イ ダ に接続す る
には以下の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［接続］ タ ブの ［ フ ァ イ ル名］ チ ェ ッ ク ボ ッ ク ス を オ ン に
し 、 新 し い フ ァ イ ルの名前 を入力す る か、 既存の フ ァ イ ル を 選択
し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "DataLink = 'oledb.udl'"
DataSource
機能
接続先のデー タ ソ ース を識別 し ま す。 デー タ ソ ース には、 使用 し てい
る OLE DB デー タ プ ロ バ イ ダに応 じ て フ ァ イ ル、 デー タ ベース 、 ま た
は ODBC デー タ ソ ー ス を指定で き ま す。
DataSource を指定する タ イ ミ ン グ
DataSource DBParm パ ラ メ ー タ は、PowerBuilder か ら デー タ ベース に接
続す る 前に指定 し ま す。
対象
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
•
40
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［接続］ タ ブの ［デー タ ソ ー ス ］ ボ ッ ク ス に EAS Demo DB
を入力 し ま す。
デー タ ベース プ ロ フ ァ イル
PowerBuilder
第1章
•
DBParm パ ラ メ ー タ
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "DataSource = 'EAS Demo DB'"
PB DataDirect OLE DB Provider を使用 し て Oracle 8 デー タ ベー ス
に接続す る には以下の よ う に し ま す。
例2
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［接続］ タ ブの ［デー タ ソ ー ス］ ボ ッ ク ス にデー タ ソ ー ス
名を入力 し ま す。 事前に、 PB DataDirect OLE DB Administrator を使
用 し てデー タ ソ ース 名を定義 し てお く 必要があ り ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "DataSource = 'Oracle8'"
Microsoft OLE DB Provider for Oracle を使用 し て Oracle 8 デー タ
ベース に接続す る には以下の よ う に し ま す。
例3
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［接続］ タ ブの ［デー タ ソ ー ス ］ ボ ッ ク ス に Oracle 8 サー
バ名を入力 し ま す。
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
デー タ ベース プ ロ フ ァ イル
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "DataSource = 'Or8server'"
関連項目
DataLink
Provider
Date
機能
デー タ ウ ィ ン ド ウ ペ イ ン タ でデー タ を更新す る と き に、 PowerBuilder
はバ ッ ク グ ラ ン ド で SQL UPDATE 文を作成 し ま す。 Date DBParm パ ラ
メ ー タ は、SQL UPDATE 文で使用す る Date デー タ 型の書式を決定 し ま
す。
対象
JDB JDBC
ODBC
O73 Oracle 7.3
O84 Oracle 8.x と Oracle8i
O90 Oracle9i
構文
Date DBParm パ ラ メ ー タ を指定す る 構文は、 デー タ ベー ス に よ っ てわ
ずかに異な り ま す。
接続 リ フ ァ レ ン ス
41
Date
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク ス で、 必要な場所に特殊文字
（引用符 と 円記号） が挿入 さ れ る ので、 指定す る のは date 型書式だけ
でか ま い ま せん。
PowerBuilder ア プ リ ケーシ ョ ン の ス ク リ プ ト では、 以下の構文 を使用
す る 必要があ り ま す。
JDBC / ODBC 構文 円記号 と こ れに続 く 2 つの単一引用符 （￥''） は、
SQL UPDATE 文が作成 さ れ る と き には 1 つの単一引用符 と し て解析 さ
れ ま す。
Date = ' ¥''date_format¥'' '
連続す る 4 つの単一引用符 （''''） は、 SQL UPDATE 文
が作成 さ れ る と き には 1 つの単一引用符 と し て解析 さ れ ま す。
Oracle 構文
Date = ' ''''date_format'''' '
パラ メ ー タ
' ¥''
' ''''
date_format
¥'' '
'''' '
デフ ォル ト 値
42
説明
JDBC / ODBC 構文 単一引用符、スペー ス、円記号、
2 つの単一引用符の順に指定 し ま す。 連続す る 2 つ
の単一引用符 と 、date 型書式の間に スペー スは入れ
ません。
Oracle 構文 単一引用符、 スペー ス、 4 つの単一引
用符の順に指定 し ま す。 連続す る 4 つの単一引用
符 と 、 Date 型書式の間に スペー ス は入れ ません。
デー タ ウ ィ ン ド ウ ペ イ ン タ において、 デー タ ソ ー
ス を更新す る ために SQL UPDATE 文を作成す る と
き に、 PowerBuilder が使用す る Date 型の書式です。
表示書式の詳細につい ては、 『ユーザーズ ガ イ ド 』
マニ ュ アル を参照 し て く だ さ い。
JDBC / ODBC 構文 円記号、 2 つの単一引用符、 ス
ペー ス、単一引用符の順に指定 し ます。 Date 型書式
と 円記号の間に ス ペー ス は入れ ません。
Oracle 構文 4 つの単一引用符、 スペー ス、 単一引
用符の順に指定 し ます。 date 型書式 と 、 4 つの連続
す る 単一引用符の間に スペース は入れま せん。
Date のデ フ ォ ル ト 値は、 以下の表に示す よ う に、 ア ク セ ス し て い る
DBMS に よ っ て異な り ま す。
DBMS
デフ ォル ト 値
JDBC
Date DBParm パ ラ メ ー タ に値が指定 さ れてい ない場合、 レ ジ ス
ト リ の JDBC ド ラ イ バに対応す る セ ク シ ョ ン で Date 型書式が検
索 さ れ ま す。 レ ジ ス ト リ で Date 型書式が見つか ら ない場合は、
JDBC の Date 型書式エ ス ケープ シーケ ン ス が使用 さ れ ます。
PowerBuilder
第1章
DBParm パ ラ メ ー タ
DBMS
デフ ォル ト 値
ODBC
Date DBParm パ ラ メ ー タ に 値 が 指 定 さ れ て い な い 場 合、
PBODB90 初期設定 フ ァ イ ルの ODBC ド ラ イ バに対応す る セ ク
シ ョ ン で Date 型書式が検索 さ れ ます。 初期設定フ ァ イ ルの中で
Date 型書式が見つか ら な い場合は、 ODBC の Date 型書式エ ス
ケープ シーケ ン ス が使用 さ れます。
Oracle
デフ ォ ル ト の Oracle Time 型書式が使用 さ れ ます。
詳細については、 Oracle のマニ ュ アル を参照 し て く だ さ い。
例
Startdate カ ラ ム を 2002-04-23 に設定す る こ と に よ
り 、 Employee と い う 名前のテーブル を更新す る も の と し ま す。 こ の日
付は、 以下の Date 型書式で表 さ れ ま す。
以下の例について
yyyy-mm-dd
例 1 （JDBC / ODBC 構文） SQL UPDATE 文 を 作成 す る と き に、 こ の
Date デー タ 型書式 を 使用す る こ と を 指定す る には以下の よ う に し ま
す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［構文］ タ ブの ［Date 型の書式］ ボ ッ ク ス で、 以下の入力
を行い ま す。
デー タ ベース プ ロ フ ァ イル
yyyy-mm-dd
•
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "Date = ' ¥''yyyy-mm-dd¥'' '"
作成 さ れ る SQL UPDATE 文 PowerBuilder は、以下の SQL UPDATE 文
を作成 し てテーブルを更新 し ま す。
UPDATE EMPLOYEE
SET STARTDATE = '2002-04-23'
SQL UPDATE 文を作成す る と き に、 こ の Date デー
タ 型書式を使用す る こ と を指定す る には以下の よ う に し ま す。
例 2 （Oracle 構文）
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［構文］ タ ブの ［Date 型の書式］ ボ ッ ク ス で、 以下の入力
を行い ま す。
デー タ ベース プ ロ フ ァ イル
yyyy-mm-dd
•
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "Date = ' ''''yyyy-mm-dd'''' '"
接続 リ フ ァ レ ン ス
43
DateFormat
作成 さ れ る SQL UPDATE 文 PowerBuilder は、以下の SQL UPDATE 文
を作成 し て テーブルを更新 し ま す。
UPDATE EMPLOYEE
SET STARTDATE = '2002-04-23'
関連項目
DateTime
Time
DateFormat
機能
デー タ ウ ィ ン ド ウ ペ イ ン タ でデー タ を更新す る と き に、 PowerBuilder
は バ ッ ク グ ラ ン ド で SQL UPDATE 文 を 作 成 し ま す。 DateFormat
DBParm パ ラ メ ー タ は、 SQL UPDATE 文で使用す る Date デー タ 型の書
式を決定 し ま す。
対象
OLE DB
構文
DateFormat = 'date_format '
パラ メ ー タ
date_format
説明
デー タ ウ ィ ン ド ウ ペ イ ン タ において、 デー タ ソ ー
ス を更新す る ために SQL UPDATE 文を作成す る と
き に、 PowerBuilder が使用す る Date 型の書式です。
表示書式の詳細につい ては、 『ユーザーズ ガ イ ド 』
マニ ュ アル を参照 し て く だ さ い。
デフ ォル ト 値
DateFormat DBParm パ ラ メ ー タ に 値 が 指定 さ れ て い な い 場合、 Date
デー タ 型は使用 さ れ ま せん。
例
Startdate カ ラ ム を 2002-04-23 に設定す る こ と に よ り 、 Employee と い う
名前のテーブルを更新す る も の と し ま す。 こ の日付は、 yyyy-mm-dd の
書式で表 さ れ ま す。
SQL UPDATE 文を作成す る と き に、こ の Date デー タ 型書式を使用す る
こ と を指定す る には以下の よ う に し ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［構文］ タ ブの ［Date 型の書式］ ボ ッ ク ス で、 以下の入力
を行い ま す。
デー タ ベース プ ロ フ ァ イル
yyyy-mm-dd
•
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "DateFormat='yyyy-mm-dd"
44
PowerBuilder
第1章
DBParm パ ラ メ ー タ
作成 さ れ る SQL UPDATE 文 PowerBuilder は、以下の SQL UPDATE 文
を作成 し てテーブルを更新 し ま す。
UPDATE EMPLOYEE
SET STARTDATE = '2002-04-23'
関連項目
DateTimeFormat
TimeFormat
DateTime
機能
デー タ ウ ィ ン ド ウ ペ イ ン タ でデー タ を更新す る と き に、 PowerBuilder
はバ ッ ク グ ラ ン ド で SQL UPDATE 文を作成 し ま す。 DateTime DBParm
パ ラ メ ー タ は、 SQL UPDATE 文で使用す る DateTime デー タ 型の書式
を決定 し ま す。 （DateTime デー タ 型には日付値 と 時刻値が両方含 ま れ
ま す）
対象
JDB JDBC
ODBC
O73 Oracle 7.3
O84 Oracle 8.x と Oracle8i
O90 Oracle9i
構文
DateTime DBParm パ ラ メ ー タ を指定す る 構文は、 デー タ ベー ス に よ っ
て わずかに異な り ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク ス で、 必要な場所に特殊文字
（引用符 と 円記号） が挿入 さ れ る ので、 指定す る のは DateTime 型書式
だけ でか ま い ま せん。
PowerBuilder ア プ リ ケーシ ョ ン ス ク リ プ ト では、 以下の構文を使用す
る 必要があ り ま す。
JDBC / ODBC 構文 PowerBuilder円記号 と こ れに続 く 2つの単一引用符
（￥''） は、 SQL UPDATE 文が作成 さ れ る と き には 1 つの単一引用符 と
し て解析 さ れ ま す。
DateTime = ' ¥''DateTime_format¥'' '
Oracle 構文 連続す る 4 つの単一引用符 （''''） は、 SQL UPDATE 文が
作成 さ れ る と き には 1 つの単一引用符 と し て解析 さ れ ま す。
DateTime = ' ''''DateTime_format'''' '
接続 リ フ ァ レ ン ス
45
DateTime
パラ メ ー タ
' ¥''
説明
' ''''
DateTime_format
表示書式の詳細につい ては、 『ユーザーズ ガ イ ド 』 マニ ュ
アル を参照 し て く だ さ い。
JDBC / ODBC 構文 円記号、2 つの単一引用符、 スペース 、
単一引用符の順に指定 し ま す。 Date 型書式 と 円記号の間
に スペース は入れま せん。
Oracle 構文 4 つの単一引用符、 スペー ス、 単一引用符の
順に指定 し ます。 DateTime 型書式 と 、4 つの連続す る単一
引用符の間に ス ペー ス は入れ ません。
¥'' '
'''' '
デフ ォル ト 値
単一引用符、 スペー ス、 円記号、 2 つ
の単一引用符の順に指定 し ます。 連続す る 2 つの単一引
用符 と 、 DateTime 型書式の間に スペー スは入れ ません。
Oracle 構文 単一引用符、 スペー ス、 4 つの単一引用符の
順に指定 し ま す。 連続す る 4 つの単一引用符 と 、 Date 型
書式の間に スペース は入れま せん。
ペ イ ン タ において、 デー タ ソ ー ス を更新す る ために SQL
UPDATE 文 を 作成す る と き に、 PowerBuilder が使用す る
DateTime 型の書式です。
JDBC / ODBC 構文
DateTime のデフ ォ ル ト 値は、 以下の表に示す よ う に、 ア ク セ ス し てい
る DBMS に よ っ て異な り ま す。
DBMS
デ フ ォル ト 値
JDBC
DateTime DBParm パ ラ メ ー タ に値が指定 さ れていない場合、 レ
ジ ス ト リ の JDBC ド ラ イ バに対応す る セ ク シ ョ ン で DateTime 型
書式が検索 さ れます。 レ ジ ス ト リ で DateTime 型書式が見つか ら
ない場合は、 JDBC の DateTime 型書式エ ス ケープ シーケ ン ス が
使用 さ れ ます。
ODBC
DateTime DBParm パ ラ メ ー タ に 値 が 指 定 さ れ て い な い 場 合、
PBODB90 初期設定フ ァ イ ルの ODBC ド ラ イ バに対応す る セ ク
シ ョ ン で DateTime 型書式が検索 さ れま す。 初期設定 フ ァ イ ルの
中で DateTime 型書式が見つか ら ない場合は、ODBC の DateTime
型書式エ ス ケープ シーケ ン ス が使用 さ れます。
Oracle
デ フ ォ ル ト の Oracle DateTime 型書式が使用 さ れます。
詳細につい ては、 Oracle のマニ ュ アル を参照 し て く だ さ い。
例
Timestamp カ ラ ム を 4/2/03 3:45 pm に設定す る こ と に
よ り 、 Files と い う 名前のテーブル を更新す る も の と し ま す。 こ の日付
は、 以下の DateTime 型書式で表 さ れ ま す。
以下の例につい て
SQL UPDATE 文 を 作 成す る と き
に、 こ の DateTime デー タ 型書式を使用す る こ と を指定す る には以下の
よ う に し ま す。
例 1 （JDBC / ODBC / OLE DB 構文）
46
PowerBuilder
第1章
•
DBParm パ ラ メ ー タ
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［構文］ タ ブの ［DateTime 型の書式］ ボ ッ ク ス で、 以下の
入力を行い ま す。
デー タ ベース プ ロ フ ァ イル
m/d/yy h:mm am/pm
•
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
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'
SQL UPDATE 文を作成す る と き に、 こ の DateTime
デー タ 型書式を使用す る こ と を指定す る には以下の よ う に し ま す。
例 2 （Oracle 構文）
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［構文］ タ ブの ［DateTime 型の書式］ ボ ッ ク ス で、 以下の
入力を行い ま す。
デー タ ベース プ ロ フ ァ イル
m/d/yy h:mm am/pm
•
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
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
47
DateTimeAllowed
DateTimeAllowed
機能
DateTimeAllowed は、イ ン タ フ ェー ス が こ の機能を サポー ト し てい る 場
合 に、 DateTime デー タ 型書式 を 持つ カ ラ ム を SQL UPDATE ま た は
DELETE 文の WHERE 句に固有キーカ ラ ム と し て表示で き る か ど う か
を 制 御 し ま す。 PowerBuilder は UPDATE 文 ま た は DELETE 文 と
INSERT 文 を 作成 し て、 デー タ ウ ィ ン ド ウ オ ブ ジ ェ ク ト か ら デー タ
ベース を更新 し ま す。
デー タ ウ ィ ン ド ウ ペ イ ン タ で作業 し てい る 場合は、更新特性の指定 ダ
イ ア ロ グ ボ ッ ク ス の ［固有 キー カ ラ ム］ リ ス ト か ら 選択す る こ と に
よ っ て、 WHERE 句に ど の カ ラ ム を入れ る か を指定 し ま す。
デフ ォ ル ト では、 DateTimeAllowed は 0 に設定 さ れ、 DateTime カ ラ ム
は ［固有キ ー カ ラ ム］ リ ス ト に表示 さ れ な いので、 UPDATE ま た は
DELETE 文の WHERE 句には表示で き ま せん。DateTimeAllowed を 1 に
設定す る と 、 デー タ ベー ス テーブル内のすべての DateTime カ ラ ム が
［固有キー カ ラ ム］ リ ス ト に表示 さ れ る ので、UPDATE ま たは DELETE
文の WHERE 句で表示 さ れ る よ う に選択で き ま す。
DateTimeAllowed を指定す る タ イ ミ ン グ
DateTimeAllowed DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー
ス に接続す る 前に指定 し ま す。
対象
IN9 Informix
MSS Microsoft SQL Server
SYC Sybase Adaptive Server Enterprise
構文
DateTimeAllowed = value
48
PowerBuilder
第1章
パラ メ ー タ
value
DBParm パ ラ メ ー タ
説明
デー タ ベー ス の更新のために 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 に設定 し ま す。
PowerBuilder の以前の リ リ ース では、 DateTime カ ラ ムは ［固有キー カ
ラ ム］ リ ス ト に表示 さ れず、 WHERE 句に表示 さ れ る よ う に選択で き ま
せんで し た。
更新特性の指定 ダ イ ア ロ グ ボ ッ ク ス を使 っ てデー タ ウ ィ ン ド ウ オブ
ジ ェ ク ト の更新特性を指定す る 際の手順については、 『ユーザーズ ガ
イ ド 』 マ ニ ュ アルの更新の制御についての章を参照 し て く だ さ い。
デー タ ウ ィ ン ド ウ オブジ ェ ク ト の保存時の処理 DateTimeAllowed を
1 に設定 し 、 WHERE 句に表示 さ れ る DateTime カ ラ ム を選択 し てか ら 、
デー タ ウ ィ ン ド ウ オブジ ェ ク ト を保存す る と 、 以降の接続で
DateTimeAllowed を 0 に設定 し て も 、 こ のカ ラ ム はその ま ま ［固有
キー カ ラ ム］ リ ス ト に表示 さ れ る よ う にな り ま す。
例
UPDATE ま たは DELETE 文の WHERE 句で DateTime カ ラ ム を使用で き
ま す。
•
接続 リ フ ァ レ ン ス
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［構文］ タ ブの ［DateTime デー タ 型の使用を許可］ チ ェ ッ
ク ボ ッ ク ス を オ ンに し ま す。
デー タ ベース プ ロ フ ァ イル
49
DateTimeFormat
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に次の よ う に入力 し ま す。
SQLCA.DBParm = "DateTimeAllowed = 1"
DateTimeFormat
機能
デー タ ウ ィ ン ド ウ ペ イ ン タ でデー タ を更新す る と き に、 PowerBuilder
は バ ッ ク グ ラ ン ド で SQL UPDATE 文 を 作成 し ま す。 DateTimeFormat
DBParm パ ラ メ ー タ は、SQL UPDATE 文で使用す る DateTime デー タ 型
の書式を決定 し ま す。 （DateTime デー タ 型には日付値 と 時刻値が両方
含 ま れ ま す）
構文
DateTimeFormat = 'datetime_format '
パラ メ ー タ
datetime_format
説明
デー タ ウ ィ ン ド ウ ペ イ ン タ において、 デー タ ソ ー
ス を更新す る ために SQL UPDATE 文を作成す る と
き に、 PowerBuilder が使用す る DateTime 型の書式
です。
表示書式の詳細につい ては、 『ユーザーズ ガ イ ド 』
マニ ュ アル を参照 し て く だ さ い。
デフ ォル ト 値
DateTimeFormat DBParm パ ラ メ ー タ に 値 が 指定 さ れ て い な い 場合、
DateTime デー タ 型は使用 さ れ ま せん。
例
Timestamp カ ラ ム を 4/2/03 3:45 pm に設定す る こ と に よ り 、Files と い う
名前のテーブルを更新す る も の と し ま す。こ の日付は、以下の DateTime
型書式で表 さ れ ま す。
SQL UPDATE 文を作成す る と き に、 こ の DateTime デー タ 型書式を使
用す る こ と を指定す る には以下の よ う に し ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［構文］ タ ブの ［DateTime 型の書式］ ボ ッ ク ス で、 以下の
入力を行い ま す。
デー タ ベース プ ロ フ ァ イル
m/d/yy h:mm am/pm
•
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "DateTimeFormat='m/d/yy h:mm am/pm'"
作成 さ れ る SQL UPDATE 文 PowerBuilder は、以下の SQL UPDATE 文
を作成 し て テーブルを更新 し ま す。
UPDATE FILES
50
PowerBuilder
第1章
DBParm パ ラ メ ー タ
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
MSS Microsoft SQL Server
ODBC（ ド ラ イ バお よ びバ ッ ク エ ン ド DBMS がサポー ト し てい る 場合）
O73 Oracle 7.3
O84 Oracle 8.x お よ び Oracle8i （8.1.5 以降のデー タ ベース 接続のみ）
O90 Oracle9i
SYC Sybase Adaptive Server Enterprise
構文
DBGetTime = value
パラ メ ー タ
value
説明
デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト 、 ク エ リ 、 ま たは レ ポー
ト が最初の行 を取得す る ま での、 DBMS か ら の応答待ち
時間です。
デ フ ォル ト 値
DBGetTime = 0
解説
DBGetTime を使用す る ための要件 DBGetTime パ ラ メ ー タ を 使用 す
る ためには、 以下の両方の操作を し ま す。
接続 リ フ ァ レ ン ス
•
Async パ ラ メ ー タ を 1 に設定 し て、 以下の例で示す よ う に、 非同期
処理を有効に し ま す。
•
データ ウ ィ ン ド ウ オブジェ ク ト ま たはレ ポート に対し て RetrieveRow
イ ベン ト を指定 し ま す。
51
DBTextLimit
例
非同期処理を有効に し た上で、DBGetTime パ ラ メ ー タ を 20 秒に設定す
る には以下の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ ト ラ ンザ ク シ ョ ン］ タ ブで、 ［非同期］ チ ェ ッ ク ボ ッ ク ス
を オ ン に し 、 ［処理待ち時間］ ボ ッ ク ス に 20 と 入力 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "Async = 1, DBGetTime = 20"
関連項目
Async
DBTextLimit
機能
SQL Server デー タ ベー ス に接続 し てい る 状態で、 SQL SELECT 文の中
に テ キ ス ト フ ィ ール ド が指定 さ れ て い る 場合、 DB-Library™ ま た は
CT-Library が返すテ キ ス ト フ ィ ール ド の最大長を指定 し ま す。
Blob （binary large object） デー タ 型 と し て扱わずに、 デー タ ウ ィ ン ド ウ
オブ ジ ェ ク ト に長いテ キ ス ト 文字列を格納 し たい場合に、 DBTextLimit
パ ラ メ ー タ を設定 し ま す。
対象
MSS Microsoft SQL Server
SYC お よ び SYJ Sybase Adaptive Server Enterprise
構文
DBTextLimit = 'value'
パラ メ ー タ
value
説明
SQL SELECT 文の中で テ キ ス ト フ ィ ール ド が指定 さ れて
い る場合に、 DB-Library ま たは CT-Library が返すテ キ ス ト
フ ィ ール ド の最大長 （バ イ ト 単位）。 0 ～ 32,763 バ イ ト の範
囲の値 を指定 し ます。
DBTextLimit に 0 を 指 定 す る と 、 DB-Library ま た は CTLibrary は最大長のテ キ ス ト フ ィ ール ド を返 し ます。
デフ ォル ト 値
DBTextLimit パラ メ ータ のデフ ォ ルト 値は、SQL Server の DBTEXTLIMIT
DB-Library ま たは CS_TEXTLIMIT CT-Library 接続プ ロ パテ ィ で指定 さ
れ る デ フ ォ ル ト 値にな り ま す。 詳細につい ては、 SQL Server のマ ニ ュ
アル を参照 し て く だ さ い。
解説
DB-Library ま た は CT-Library が 返す テ キ ス ト フ ィ ール ド の 長 さ は、
DBTextLimit 値 と 、 SQL Server グ ロ ーバル変数 @@textsize の設定の、
ど ち ら か小 さ いほ う の値に相当 し ま す。
52
PowerBuilder
第1章
DBParm パ ラ メ ー タ
@@textsize の設定の ほ う が DBTextLimit に指定 し た 値 よ り 小 さ い場
合、 DB-Library ま たは CT-Library は @@textsize の値を返 し ま す。
例
SQL SELECT 文に テ キ ス ト フ ィ ール ド が指定 さ れ て い る 場合、 DBLibrary ま たは CT-Library が返すテ キ ス ト フ ィ ール ド の長 さ が最大で
32,000 バ イ ト であ る こ と を指定す る には以下の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［構文］ タ ブの ［テ キ ス ト の最大値］ ボ ッ ク ス に 32000 と
入力 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ン ス ク リ プ ト に、 次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "DBTextLimit = '32000'"
DecimalSeparator
機能
PowerBuilder か ら ア ク セ ス し て い る バ ッ ク エ ン ド DBMS が使用す る 、
小数点記号を指定 し ま す。 デフ ォ ル ト で あ る ピ リ オ ド （.） 以外の小数
点記号を DBMS で使用 し てい る 場合、 デー タ ベース か ら 返 さ れ る 数値
文字列を PowerBuilder で正 し く 処理で き る よ う に、 DBMS に合わせた
値を DecimalSeparator に設定 し ま す。
対象
IN9 Informix
ODBC（ ド ラ イ バお よ びバ ッ ク エ ン ド DBMS がサポー ト し てい る 場合）
OLE DB
O73 Oracle 7.3
O84 Oracle 8.x お よ び Oracle8 i
O90 Oracle9i
構文
DecimalSeparator = 'value'
パラ メ ー タ
value
デ フ ォル ト 値
接続 リ フ ァ レ ン ス
説明
PowerBuilder か ら ア ク セ ス し てい る バ ッ ク エ ン ド DBMS が
使用す る、 小数点記号。 以下のいずれかの値を指定 し ます。
• '.' （デフ ォ ル ト ） バ ッ ク エン ド DBMS が、 小数点記号 と
し て ピ リ オ ド （.） を 使 用 す る こ と を 指 定 し ま す。
DecimalSeparator パ ラ メ ー タ を指定 し なか っ た場合、 ま た
は ピ リ オ ド （.） やカ ン マ （,） 以外の値 を指定 し た場合、
小数点記号 と し て ピ リ オ ド （.） が使用 さ れ ます。
• ',' バ ッ ク エ ン ド DBMS が、 小数点記号 と し て カ ン マ （,）
を使用す る こ と を指定 し ます。
DecimalSeparator = '.'
53
DelimitIdentifier
解説
DecimalSeparator の指定が必要な場合 DecimalSeparator DBParm パ ラ
メ ー タ の値 と し ては、 現在の と こ ろ、 ピ リ オ ド （.） と カ ン マ （,） が有
効です。 し たがっ て、 ア ク セ ス し てい る DBMS におけ る 小数点記号の
設定がカ ン マの場合は、DecimalSeparator DBParm パ ラ メ ー タ を ',' （カ
ン マ） に設定す る こ と に よ っ て、 デー タ ベース か ら 返 さ れ る 数値文字
列を PowerBuilder が正 し く 処理で き る よ う に し ま す。
Oracle の例 PowerBuilder か ら Oracle デー タ ベース にア ク セ ス し てい
て、 小数点記号の設定は カ ン マ （,） で あ る も の と し ま す。 Oracle か ら
PowerBuilder に返 さ れ る '123,50' と い う 数値文字列の小数点記号は、 ピ
リ オ ド では な く カ ン マです。 PowerBuilder は こ の文字列を、 自身の十
進変換ルーチ ン に送 り ま す。
デ フ ォ ル ト では、 PowerBuilder の十進変換ルーチ ン は、 ピ リ オ ド を小
数点記号 と し て 処理 し ま す。 DecimalSeparator DBParm パ ラ メ ー タ を
',' （カ ン マ） に設定す る こ と に よ っ て、 PowerBuilder は こ の文字列を
正 し く 処理 し 、 '123,50' と し て返す こ と がで き ま す。
例
ア ク セ ス し てい る DBMS が、 小数点記号 と し て カ ン マ （,） を使用す る
こ と を指定す る には以下の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［構文］ タ ブ の ［小数点の記号］ ボ ッ ク ス に、 カ ン マ （,）
を入力 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "DecimalSeparator = ','"
関連項目
NumericFormat
DelimitIdentifier
機能
SQL 文を 作成す る と き に、 テーブル名、 カ ラ ム 名、 イ ン デ ッ ク ス 名、
制約名を 二重引用符で囲むか ど う か を指定 し ま す。 こ の設定は、 SQL
文を作成す る PowerBuilder のペ イ ン タ の動作に影響 し ま す。
DelimitIdentifier を指定する タ イ ミ ン グ
DelimitIdentifier DBParm パ ラ メ ー タ は、PowerBuilder か ら デー タ ベー ス
に接続す る 前に指定 し ま す。
対象
54
IN9 Informix
JDB JDBC
PowerBuilder
第1章
DBParm パ ラ メ ー タ
ODBC（ ド ラ イ バお よ びバ ッ ク エ ン ド DBMS がサポー ト し てい る 場合）
OLE DB
O73 Oracle 7.3
O84 Oracle 8.x お よ び Oracle8 i
O90 Oracle9i
SYC Sybase Adaptive Server Enterprise
構文
DelimitIdentifier = 'value'
パラ メ ー タ
value
デ フ ォル ト 値
説明
PowerBuilder におい て、テーブルやカ ラ ム の名前を二重引
用符で囲むか ど う か を指定す る 値。以下のいずれかの値を
指定 し ます。
• Yes テーブル名やカ ラ ム名を二重引用符で囲みま す。
• No テ ー ブ ル 名や カ ラ ム 名 を 二重引用符 で囲み ま せ
ん。
DelimitIdentifier パ ラ メ ー タ のデフ ォ ル ト 値は、以下の表に示す よ う に、
ア ク セ ス し てい る DBMS に よ っ て異な り ま す。
DBMS
DelimitIdentifer パ ラ メ ー タ のデ フ ォ ル ト 値
Informix
DelimitIdentifier = 'No'
JDBC
レ ジ ス ト リ の DelimitIdentifer 設定 に 依存 し
ま す。
ODBC
PBODB90 初期設定フ ァ イ ルの DelimitIdentifer
設定に依存し ま す。
Oracle
DelimitIdentifier = 'Yes'
OLE DB
Sybase
Adaptive
Enterprise
解説
DelimitIdentifier = 'Yes'
Server
DelimitIdentifier = 'No'
Informix Informix データ ベース サーバでは、ASCII ま た は非 ASCII の
いずれかの書式でデータ ベース ト ラ ン ザク シ ョ ン のロ グ を 作成でき ま
す。データ ベース で非 ASCII ロ グ を 作成し て いる 場合、DelimitIdentifier
の設定はオプシ ョ ン です。 デー タ ベー ス で ASCII ロ グ を作成 し てい る
場合、 PowerBuilder に よ っ て生成 さ れ る SQL 構文を想定通 り に動作 さ
せ る には、 DelimitIdentifier = 'Yes' を設定す る 必要があ り ま す。
JDBC お よ び ODBC DelimitIdentifier DBParm パ ラ メ ー タ の設定は、レ
ジ ス ト リ で JDBC ド ラ イ バに対 し て指定 さ れてい る DelimitIdentifier の
設定、 お よ び PBODB90 初期設定フ ァ イ ルの中で ODBC ド ラ イ バに対
し て指定 さ れてい る DelimitIdentifier の設定に優先 し ま す。
接続 リ フ ァ レ ン ス
55
DisableBind
例
PowerBuilder が SQL 文を作成す る と き に、 テーブル名 と カ ラ ム名を二
重引用符で囲ま ない こ と を指定す る には以下の よ う に し ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［構文］ タ ブ の ［テーブル名お よ びカ ラ ム 名を 引用符で囲
む］ チ ェ ッ ク ボ ッ ク ス を オ フ に し ま す。
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
デー タ ベース プ ロ フ ァ イル
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "Delimitidentifier = 'No'"
DisableBind
機能
バ イ ン ド 変数を サポー ト す る DBMS に対 し て、 PowerBuilder はデフ ォ
ル ト で、 コ ン パ イ ル済みの SQL 文に入力パ ラ メ ー タ を バ イ ン ド し ま
す。 DisableBind パ ラ メ ー タ を使用す る と 、 こ のデフ ォ ル ト の変数バ イ
ン ド を禁止で き ま す。
DisableBind パ ラ メ ー タ に 1 を設定す る と バ イ ン ド が禁止 さ れ、 入力変
数は、 ア プ リ ケーシ ョ ン ユーザに よ っ て入力 さ れた値や PowerBuilder
ス ク リ プ ト で指定 さ れた値に置 き 換え ら れ ま す。
対象
IN9 Informix
JDB JDBC
ODBC（ ド ラ イ バお よ びバ ッ ク エ ン ド DBMS がサポー ト し てい る 場合）
O73 Oracle 7.3
O84 Oracle 8.x と Oracle8i
O90 Oracle9i
構文
DisableBind = value
パラ メ ー タ
value
デフ ォル ト 値
56
説明
コ ン パ イ ル済みの SQL 文に対 し て、 入力パ ラ メ ー タ のデ
フ ォ ル ト バ イ ン ド を禁止す る か ど う か を指定す る 値。以下
のいずれかの値 を指定 し ます。
• 0 （デフ ォ ル ト ） コ ン パ イ ル済みの SQL 文に対 し て、 入
力パ ラ メ ー タ をバ イ ン ド し ます。
• 1 コ ン パ イ ル済みの SQL 文に対 し て、 入力パ ラ メ ー タ
をバ イ ン ド し ません。
DisableBind = 0
PowerBuilder
第1章
解説
DBParm パ ラ メ ー タ
バ イ ン ド 変数 SQL 文において、 バ イ ン ド 変数は カ ラ ム値のプ レー ス
ホルダー と し て使用 さ れ ま す。 デフ ォ ル ト では、 PowerBuilder は SQL
文を実行す る たびに、 ア プ リ ケーシ ョ ン で定義 さ れた変数か ら デー タ
をバ イ ン ド 変数に関連付け （バ イ ン ド ） し ま す。
SQL 文の中でのバ イ ン ド 変数の使い方 た と えば、 以下の SQL 文は、
Books テーブルか ら Hemingway に よ っ て書かれた書籍に関す る 行を取
得 し ま す。
SELECT * FROM books WHERE author = "Hemingway"
こ の ス テー ト メ ン ト を実行 し て、 ほかの著者が執筆 し た書籍に関す る
情報を取得す る も の と し ま す。 著者ご と に SQL 文を コ ンパ イ ル し て実
行す る 代わ り に、 著者名を表わすバ イ ン ド 変数を定義す る こ と がで き
ま す。 こ れに よ っ て、 エ ン ド ユーザは、 アプ リ ケーシ ョ ン を実行す る
と き に、 著者の名前を指定す る こ と にな り ま す。 バ イ ン ド 変数を使用
す る と 、 SQL 文を 1 回 コ ンパ イ ルす る だけで、 エ ン ド ユーザが指定す
る 新 し い値で繰 り 返 し こ れを実行す る こ と がで き ま す。
使用す る デー タ ベー ス が バ イ ン ド 変数 を サ ポ ー ト し て い て、 か つ、
DisableBind パ ラ メ ー タ が 0 （デフ ォ ル ト ） に設定 さ れバ イ ン ド が許可
さ れ てい る 場合、 PowerBuilder はパ ラ メ ー タ マーカ ー （:bind_param）
のあ る SQL 文を作成 し 、 実行時に実際のパ ラ メ ー タ 値を渡 し ま す。 こ
の例を以下に示 し ま す。
SELECT * FROM books WHERE author = :bind_param
バ イ ン ド 変数 と キ ャ ッ シ ュ 文 キ ャ ッ シ ュ 文 と バ イ ン ド 変数 を同時に
使用す る と 、 ほ と ん ど のア プ リ ケーシ ョ ン の実行速度を改善す る こ と
がで き ま す。 改善の程度は アプ リ ケーシ ョ ン ご と にそれぞれ異な り ま
す。 一般に、 大量の ト ラ ン ザ ク シ ョ ン を処理す る ア プ リ ケーシ ョ ン ほ
ど 、 バ イ ン ド 変数 と キ ャ ッ シ ュ 文が効果を発揮 し ま す。
キ ャ ッ シ ュ 文を使用す る には、 DisableBind パ ラ メ ー タ を 0 （デフ ォ ル
ト ） に設定 し ま す。 こ れに よ っ て、 PowerBuilder におけ る 、 SQL 文へ
の入力変数 のバ イ ン ド が 許可 さ れ ま す。 キ ャ ッ シ ュ 文 につい て は、
SQLCache パ ラ メ ー タ についての解説を参照 し て く だ さ い。
パ フ ォ ーマ ン ス の向上 Adaptive Server Anywhere や Oracle デー タ ベー
ス に対 し て、 PowerBuilder で 255 文字を超え る 文字列の修正や挿入を
許可す る 場合、 バ イ ン ド 変数に よ る パフ ォ ーマ ン ス の改善が見 ら れ ま
す。
接続 リ フ ァ レ ン ス
57
DisableBind
バ イ ン ド 変数 と デフ ォ ル ト のカ ラ ム値 DisableBind パ ラ メ ー タ が 0 に
設定 さ れ、 バ イ ン ド 変数を使用す る こ と が許可 さ れ る と 、 デー タ ウ ィ
ン ド ウ ペ イ ン タ は以下の処理を 両方 と も 実行 し ま す。 こ れに よ っ て、
デー タ ウ ィ ン ド ウ オブジ ェ ク ト に行を追加す る と き 、 バ イ ン ド 変数を
使用す る こ と でパ フ ォ ーマ ン ス が最大限に改善 さ れ ま す。
•
すべてのカ ラ ム （identity カ ラ ムや SQL Server timestamp カ ラ ム は
除 く ） があ る SQL INSERT 文を作成 し ま す。
•
デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト に追加す る 行ご と に、 こ の SQL
INSERT 文を繰 り 返 し 使用 し ま す。
た と え ば、 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 デ フ ォ ル ト 値に等 し い初期値 を、
デー タ ウ ィ ン ド ウ オブジ ェ ク ト カ ラ ムに設定 し ま す。
デー タ ウ ィ ン ド ウ ペ イ ン タ では、 カ ラ ム の仕様 ダ イ ア ロ グ ボ ッ ク ス
で、 カ ラ ム の初期値の設定や変更がで き ま す。
58
PowerBuilder
第1章
DBParm パ ラ メ ー タ
カ ラ ム の仕様 ダ イ ア ロ グ ボ ッ ク ス の詳細については、 『ユーザーズ ガ
イ ド 』 マ ニ ュ アルを参照 し て く だ さ い。
バ イ ン ド が禁止 さ れてい る 状態でのデフ ォ ル ト カ ラ ム値の設定 バ
イ ン ド 変数を使用 し ていない （DisableBind パ ラ メ ー タ が 1 に設定 さ れ
てい る ） 状態で、 アプ リ ケーシ ョ ン ユーザが新 し い行に値を明示的に
入力 し なか っ た と き 、 バ ッ ク エ ン ド DBMS がそのデフ ォ ル ト 値を設定
す る ために、 デー タ ウ ィ ン ド ウ カ ラ ム に初期値を設定す る 必要は あ り
ま せん。
こ れは、 バ イ ン ド 変数が禁止 さ れてい る 場合、 デー タ ウ ィ ン ド ウ ペ イ
ン タ は、 デー タ ウ ィ ン ド ウ に追加 さ れ る 行ご と に、 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 プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ ト ラ ン ザ ク シ ョ ン］ タ ブの ［バ イ ン ド の抑制］ チ ェ ッ ク
ボ ッ ク ス を オ ン に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "DisableBind = 1"
関連項目
SQLCache
Driver
機能
接続 リ フ ァ レ ン ス
ア プ リ ケーシ ョ ン がデー タ ベース に接続す る ために使用す る JDBC ド
ラ イ バです。
59
Driver
Driver を指定する タ イ ミ ン グ
Driver DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベース に接続す
る 前に指定 し ま す。
対象
JDB JDBC
構文
Driver = 'driver_name'
デフ ォル ト 値
なし
解説
ド ラ イ バ名は、 デー タ ベース に接続す る ために使用 し てい る 特定の ド
ラ イ バの Java ク ラ ス 名を識別 し ま す。
例
例1
Sybase jConnect ド ラ イ バの ド ラ イ バ名を 設定す る には以下の よ
う に し ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［接続］ タ ブの ［ ド ラ イ バ名］ ボ ッ ク ス で以下の入力 を行
い ま す。
デー タ ベース プ ロ フ ァ イル
com.sybase.jdbc.SybDriver
•
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "Driver =
'com.sybase.jdbc.SybDriver'"
Oracle JDBC ド ラ イ バの ド ラ イ バ名を設定す る には以下の よ う に
し ま す。
例2
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［接続］ タ ブの ［ ド ラ イ バ名］ ボ ッ ク ス で以下の入力 を行
い ま す。
デー タ ベース プ ロ フ ァ イル
oracle.jdbc.driver.OracleDriver
•
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "Driver =
'oracle.jdbc.driver.OracleDriver'"
関連項目
60
URL
PowerBuilder
第1章
DBParm パ ラ メ ー タ
DS_Alias
機能
DS_Alias は、 PowerBuilder か ら Open Client を経由 し て Sybase Adaptive
Server Enterprise デー タ ベー ス にア ク セ ス す る と き に、 ア プ リ ケーシ ョ
ン でネ ッ ト ワ ー ク ベー ス のデ ィ レ ク ト リ サー ビ ス を有効にす る た め
に設定で き る DBParm パ ラ メ ー タ の う ちの 1 つです。 ほかのデ ィ レ ク
ト リ サービ ス DBParm パ ラ メ ー タ については、 以下の 「関連項目」 を
参照 し て く だ さ い。
一部のデ ィ レ ク ト リ サービ ス プ ロ バ イ ダお よ び ド ラ イ バは、エ リ ア ス
エ ン ト リ の作成をサポー ト し てい ま す。 エ リ ア ス エ ン ト リ は、 階層内
のプ ラ イ マ リ デ ィ レ ク ト リ エ ン ト リ への リ ン ク を提供 し 、 特定のネ ッ
ト ワ ー ク エ ン テ ィ テ ィ を探 し てデ ィ レ ク ト リ 構造を検索す る と き に、
ユーザが複数の方法で プ ラ イ マ リ エ ン ト リ へア ク セ ス で き る よ う に
し ま す。
DS_Alias は、デ ィ レ ク ト リ サービ ス プ ロ バ イ ダお よ び ド ラ イ バがエ リ
ア ス を サポー ト し てい る 場合、 デ ィ レ ク ト リ 階層の検索時に、 プ ロ バ
イ ダがエ リ ア ス エ ン ト リ に対す る リ ン ク を た ど る （エ リ ア ス エ ン ト リ
を展開す る ） こ と がで き る よ う にす る か ど う か を指定 し ま す。 デフ ォ
ル ト 動作では、 こ の機能をサポー ト し てい る プ ロ バ イ ダはエ リ ア ス エ
ン ト リ を展開で き ま す。
DS_Alias DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー ス に接
続す る 前に指定 し ま す。
サー ド パーテ ィ のデ ィ レ ク ト リ サービ ス プ ロバ イ ダの使用
Sybase が Open Client デ ィ レ ク ト リ サービ ス で テ ス ト を行っ たサー ド
パーテ ィ のデ ィ レ ク ト リ サー ビ ス プ ロ バ イ ダお よ びオペ レーテ ィ ン
グ シ ス テ ム プ ラ ッ ト フ ォ ーム の詳細については、Open Client の ド キ ュ
メ ン ト を参照 し て く だ さ い。
対象
SYC Sybase Adaptive Server Enterprise
構文
DS_Alias = value
接続 リ フ ァ レ ン ス
61
DS_Alias
パラ メ ー タ
value
説明
デ ィ レ ク ト リ サー ビ ス プ ロ バ イ ダお よ び ド ラ イ バがエ リ
ア ス をサ ポー ト し てい る 場合、デ ィ レ ク ト リ 階層の検索時
に、 プ ロ バ イ ダがエ リ ア ス エ ン ト リ を展開で き る か ど う
か を指定す る 値。 以下のいずれかの値を指定 し ます。
• 0 デ ィ レ ク ト リ 検索時に、 プ ロ バ イ ダはエ リ ア ス エ ン
ト リ を展開で き ません。 ま た、 'No' ま たは 'False' を
こ の値に指定す る こ と も で き ます。
• 1 （デフ ォ ル ト ） デ ィ レ ク ト リ 検索時に、 プ ロ バ イ ダは
エ リ ア ス エン ト リ を展開で き ます。 ま た、'Yes' ま たは
'True' を こ の値に指定す る こ と も で き ます。
デフ ォル ト 値
DS_Alias = 1
解説
設定が必要な場合 デ ィ レ ク ト リ エ リ ア ス エ ン ト リ を 通 じ てデー タ
にア ク セ ス で き ない よ う にす る には、 DS_Alias を 0 に設定 し ま す。 こ
の設定に よ り 、エ リ ア ス を サポー ト し てい る デ ィ レ ク ト リ サービ ス プ
ロ バ イ ダはデ ィ レ ク ト リ 検索時にエ リ ア ス エ ン ト リ を 展開で き な く
な り ま す。
Release DBParm の設定 DS_Alias を有効にす る には、 Release DBParm
パ ラ メ ー タ に '11'、 '11.5'、 '12'、 '12.5' のいずれ か を 設定 し て、 ア プ リ
ケ ー シ ョ ン が適切 な バー ジ ョ ン の Sybase Open Client Client-Library™
（CT-Lib） の動作を使用す る こ と を指定す る 必要があ り ま す。
使用のための要件 DS_Alias ま たは、Open Client デ ィ レ ク ト リ サービ
ス を サ ポ ー ト し て い る ほ か の DBParm パ ラ メ ー タ を 使用す る に は、
PowerBuilder ア プ リ ケーシ ョ ン でデ ィ レ ク ト リ サービ ス を使用す る た
め の一定 の要件 を 満 た し て い る 必要 が あ り ま す。 詳細 につい て は、
『デー タ ベー ス と の接続』 マ ニ ュ ア ルの 「Open Client のデ ィ レ ク ト リ
サービ ス を使用す る ための条件」 を参照 し て く だ さ い。
対応す る CT-Lib 接続プ ロ パテ ィ DS_Alias に値を指定す る と 、
CS_DS_EXPANDALIAS と い う 名前の、 対応す る Sybase CT-Lib 接続プ
ロ パテ ィ が設定 さ れ ま す。
例
エ リ ア ス を サ ポ ー ト し て い る デ ィ レ ク ト リ サー ビ ス プ ロ バ イ ダ が
デ ィ レ ク ト リ 検索時にエ リ ア ス エ ン ト リ を 展開で き な い よ う にす る
には、 以下の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［デ ィ レ ク ト リ サービ ス ］ タ ブの ［デ ィ レ ク ト リ エ リ ア ス
エ ン ト リ ］ チ ェ ッ ク ボ ッ ク ス を オ フ に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に次の よ う に入力 し ま す。
62
PowerBuilder
第1章
DBParm パ ラ メ ー タ
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 デー タ ベー ス にア ク セ ス す る と き に、 ア プ リ ケーシ ョ
ン でネ ッ ト ワ ー ク ベー ス のデ ィ レ ク ト リ サー ビ ス を有効にす る た め
に設定で き る DBParm パ ラ メ ー タ の う ちの 1 つです。 ほかのデ ィ レ ク
ト リ サービ ス DBParm パ ラ メ ー タ については、 以下の 「関連項目」 を
参照 し て く だ さ い。
一部のデ ィ レ ク ト リ サービ ス プ ロ バ イ ダお よ び ド ラ イ バは、キ ャ ッ シ
ン グ の使用を サポー ト し てい ま す。 キ ャ ッ シ ン グ は、 デ ィ レ ク ト リ 検
索時に、 デ ィ レ ク ト リ サー ビ ス プ ロ バ イ ダ が、 デ ィ レ ク ト リ サーバ
エージ ェ ン ト に対 し て情報を要求す る 代わ り に、 キ ャ ッ シ ュ さ れてい
る 情報を使用で き る よ う に し ま す。
DS_Copy は、 デ ィ レ ク ト リ サー ビ ス プ ロ バ イ ダ お よ び ド ラ イ バ が
キ ャ ッ シ ン グ を サポー ト し てい る 場合、 デ ィ レ ク ト リ 検索時にプ ロ バ
イ ダがキ ャ ッ シ ュ さ れてい る 情報を使用で き る よ う にす る か ど う か を
指定 し ま す。 デフ ォ ル ト 動作では、 こ の機能をサポー ト し てい る プ ロ
バ イ ダはキ ャ ッ シ ュ さ れてい る 情報を使用で き ま す。
DS_Copy DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー ス に接
続す る 前に指定 し ま す。
サー ド パーテ ィ のデ ィ レ ク ト リ サービ ス プ ロバ イ ダの使用
Sybase が Open Client デ ィ レ ク ト リ サービ ス で テ ス ト を行っ たサー ド
パーテ ィ のデ ィ レ ク ト リ サー ビ ス プ ロ バ イ ダお よ びオペ レーテ ィ ン
グ シ ス テ ム プ ラ ッ ト フ ォ ーム の詳細については、Open Client の ド キ ュ
メ ン ト を参照 し て く だ さ い。
対象
接続 リ フ ァ レ ン ス
SYC Sybase Adaptive Server Enterprise
63
DS_Copy
構文
DS_Copy = value
パラ メ ー タ
value
説明
デ ィ レ ク ト リ サー ビ ス プ ロ バ イ ダお よ び ド ラ イ バが
キ ャ ッ シ ン グ をサ ポー ト し てい る 場合、デ ィ レ ク ト リ 検索
時に ド ラ イ バが キ ャ ッ シ ュ さ れてい る 情報 を 使用で き る
か ど う か を 指定す る 値。 以下の いずれかの値 を 指定 し ま
す。
• 0 プ ロ バ イ ダはデ ィ レ ク ト リ 検索時に キ ャ ッ シ ュ さ れ
て い る 情 報 を 使 用 で き ま せ ん。 ま た、 'No' ま た は
'False' を こ の値に指定す る こ と も で き ます。
• 1 （デ フ ォ ル ト ） プ ロ バ イ ダはデ ィ レ ク ト リ 検索時に
キ ャ ッ シ ュ さ れ て い る 情 報 を 使 用 で き ま す。 ま た、
'Yes' ま たは 'True' を こ の値に指定す る こ と も で き ま
す。
デフ ォル ト 値
DS_Copy = 1
解説
設定が必要な場合 デ ィ レ ク ト リ 検索時に、 プ ロ バ イ ダがキ ャ ッ シ ュ
さ れてい る 情報を使用で き る よ う にす る と 、 検索処理を よ り 高速に行
え ま す。 ただ し そ の場合、 プ ロ バ イ ダが最新のデ ィ レ ク ト リ 情報を使
用 し てい る か ど う かは保証 さ れ ま せん。
最新のデ ィ レ ク ト リ エ ン ト リ の変更を ア プ リ ケ ーシ ョ ン が取得す る
こ と が保証 さ れ る よ う にす る には、 DS_Copy を 0 に設定 し て、 キ ャ ッ
シ ン グ を サポー ト し てい る プ ロ バ イ ダがデ ィ レ ク ト リ 検索時に キ ャ ッ
シ ュ さ れてい る 情報を使用で き ない よ う に し ま す。
Release DBParm の設定 DS_Copy を有効にす る には、 Release DBParm
パ ラ メ ー タ に '11'、 '11.5'、 '12'、 '12.5' のいずれ か を 設定 し て、 ア プ リ
ケ ー シ ョ ン が適切 な バー ジ ョ ン の Sybase Open Client Client-Library™
（CT-Lib） の動作を使用す る こ と を指定す る 必要があ り ま す。
使用のための要件 DS_Copy ま たは、Open Client デ ィ レ ク ト リ サービ
ス を サ ポ ー ト し て い る ほ か の DBParm パ ラ メ ー タ を 使用す る に は、
PowerBuilder ア プ リ ケーシ ョ ン でデ ィ レ ク ト リ サービ ス を使用す る た
め の一定 の要件 を 満 た し て い る 必要 が あ り ま す。 詳細 につい て は、
『デー タ ベー ス と の接続』 マ ニ ュ ア ルの 「Open Client のデ ィ レ ク ト リ
サービ ス を使用す る ための条件」 を参照 し て く だ さ い。
対応す る CT-Lib 接続プ ロ パテ ィ DS_Copy に値を指定す る と 、
CS_DS_COPY と い う 名前の、 対応す る Sybase CT-Lib 接続プ ロ パテ ィ
が設定 さ れ ま す。
例
キ ャ ッ シ ン グ を サポー ト し てい る デ ィ レ ク ト リ サービ ス プ ロ バ イ ダ
がデ ィ レ ク ト リ 検索時にキ ャ ッ シ ュ さ れてい る 情報を使用で き ない よ
う にす る には、 以下の よ う に し ま す。
64
PowerBuilder
第1章
DBParm パ ラ メ ー タ
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［デ ィ レ ク ト リ サービ ス ］ タ ブの ［キ ャ ッ シ ュ の使用］ チ ェ ッ
ク ボ ッ ク ス を オ フ に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に次の よ う に入力 し ま す。
SQLCA.DBParm = "DS_Copy = 0"
関連項目
DS_Alias
DS_DitBase
DS_Failover
DS_Password
DS_Principal
DS_Provider
DS_TimeLimit
Release
DS_DitBase
機能
DS_DitBase は、 PowerBuilder か ら Open Client を 経 由 し て Sybase
Adaptive Server Enterprise デー タ ベース にア ク セ スす る と き に、 アプ リ
ケーシ ョ ン で ネ ッ ト ワ ー ク ベー ス のデ ィ レ ク ト リ サー ビ ス を 有効に
す る ために設定で き る DBParm パ ラ メ ー タ の う ちの 1 つです。 ほかの
デ ィ レ ク ト リ サービ ス DBParm パ ラ メ ー タ については、 以下の 「関連
項目」 を参照 し て く だ さ い。
Open Client デ ィ レ ク ト リ サービ ス を使用す る と き には、 Open
Client/Server™ Configuration ユーテ ィ リ テ ィ で、 デフ ォ ル ト の （ア ク
テ ィ ブ な） デ ィ レ ク ト リ 情報ツ リ ーベー ス （DIT ベース ） が指定 さ れ
ま す。 DIT ベー ス は、 デ ィ レ ク ト リ 検索が開始 さ れ る デ ィ レ ク ト リ
ノ ー ド です。 MS-DOS フ ァ イ ル シ ス テ ム の現行の作業デ ィ レ ク ト リ に
似てい ま す。
DS_DitBase を使 う と 、デ ィ レ ク ト リ エ ン ト リ の検索を開始す る デ ィ レ
ク ト リ ノ ー ド の名前を指定で き ま す。 指定す る DS_DitBase 値は、 デ ィ
レ ク ト リ サー ビ ス プ ロ バ イ ダ お よ び ド ラ イ バ で 要求 さ れ る 構文 を
使っ た絶対パ ス 名でなければな り ま せん （以下の 「例」 を参照）。
DS_DitBase の デ フ ォ ル ト 値 は、 Open Client/Open Server Configuration
ユーテ ィ リ テ ィ で現在ア ク テ ィ ブに指定 さ れてい る DIT ベー ス です。
DS_DitBase DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー ス に
接続す る 前に指定 し ま す。
接続 リ フ ァ レ ン ス
65
DS_DitBase
サー ド パーテ ィ のデ ィ レ ク ト リ サー ビ ス プ ロバ イ ダの使用
Sybase が Open Client デ ィ レ ク ト リ サービ ス で テ ス ト を行っ たサー ド
パーテ ィ のデ ィ レ ク ト リ サー ビ ス プ ロ バ イ ダお よ びオペ レ ーテ ィ ン
グ シ ス テ ム プ ラ ッ ト フ ォーム の詳細については、Open Client の ド キ ュ
メ ン ト を参照 し て く だ さ い。
対象
SYC Sybase Adaptive Server Enterprise
構文
DS_DitBase = 'dit_base'
パラ メ ー タ
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 DBParm の設定 DS_DitBase を有効にす る には、 Release
DBParm パ ラ メ ー タ に '11'、 '11.5'、 '12'、 '12.5' のいずれか を設定 し て、
ア プ リ ケーシ ョ ン が適切なバージ ョ ン の Sybase Open Client
Client-Library （CT-Lib） の動作を使用す る こ と を指定す る 必要があ り
ま す。
66
PowerBuilder
第1章
DBParm パ ラ メ ー タ
使用のための要件 DS_DitBase ま たは、Open Client デ ィ レ ク ト リ サー
ビ ス を サポー ト し てい る ほ かの DBParm パ ラ メ ー タ を使用す る には、
PowerBuilder ア プ リ ケーシ ョ ン でデ ィ レ ク ト リ サービ ス を使用す る た
め の 一定の 要件 を 満 た し て い る 必要が あ り ま す。 詳細 につい て は、
『デー タ ベー ス と の接続』 マ ニ ュ アルの 「Open Client のデ ィ レ ク ト リ
サービ ス を使用す る ための条件」 を参照 し て く だ さ い。
対応す る CT-Lib 接続プ ロ パテ ィ DS_DitBase に値を指定す る と 、
CS_DS_DitBase と い う 名前の、 対応す る Sybase CT-Lib 接続プ ロ パ
テ ィ が設定 さ れ ま す。
例
以下の例は、さ ま ざ ま なデ ィ レ ク ト リ サービ ス プ ロ
バ イ ダで 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
•
PowerBuilder ス ク リ プ
ト で、 以下の入力 を 行い ま す。 DS_DitBase の値は、 円記号 （￥）
で終わ っ ていてはな り ま せん。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
SQLCA.DBParm =
"DS_DitBase='SALES:software¥sybase¥server'"
例 2 （DCE/CDS） 以下の例は、 デ ィ レ ク ト リ サー ビ ス プ ロ バ イ ダ が
Distributed Computing Environment Cell Directory Services （DCE/CDS） で
あ る 場合の DS_DitBase の構文を示 し ま す。
Node name:/.../boston.sales/dataservers/sybase/SYS11
DS_DitBase: /.../boston.sales/dataservers
DS_DitBase を設定す る には、 以下の よ う に し ま す。
接続 リ フ ァ レ ン ス
67
DS_DitBase
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［デ ィ レ ク ト リ サー ビ ス ］ タ ブ の ［DIT ベー ス ］ ボ ッ ク ス
で、 以下の入力を 行い ま す。 DS_DitBase の値は、 ス ラ ッ シ ュ （/）
で終わっ ていてはな り ま せん。
デー タ ベース プ ロ フ ァ イル
/.../boston.sales/dataservers
•
PowerBuilder ス ク リ プ
ト で、 以下の入力を行い ま す。 DS_DitBase の値は、 ス ラ ッ シ ュ （/）
で終わっ ていてはな り ま せん。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
SQLCA.DBParm =
"DS_DitBase =
'/.../boston.sales/dataservers'"
以下の例は、 デ ィ レ ク ト リ サービ ス プ ロ バ イ ダ
が Banyan StreetTalk Directory Assistance （STDA） で あ る 場 合 の
DS_DitBase の構文を示 し ます。
Node name: SYS11@sales@chicago
DS_DitBase: chicago
例 3 （Banyan STDA）
DS_DitBase を設定す る には、 以下の よ う に し ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［デ ィ レ ク ト リ サー ビ ス ］ タ ブ の ［DIT ベー ス ］ ボ ッ ク ス
で、 以下の入力を行い ま す。 DS_DitBase の値は、 @ か ら 始めては
な り ま せん 。
デー タ ベース プ ロ フ ァ イル
chicago
•
以下の入力 を 行い ま
す。 DS_DitBase の値は、 @ か ら 始めてはな り ま せん 。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
SQLCA.DBParm = "DS_DitBase = 'chicago'"
以下の例は、 デ ィ レ ク ト リ サービ ス プ ロ バ イ ダが
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
例 4 （Novell NDS）
DS_DitBase を設定す る には、 以下の よ う に し ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［デ ィ レ ク ト リ サー ビ ス ］ タ ブ の ［DIT ベー ス ］ ボ ッ ク ス
で、 以下の入力を行い ま す。
デー タ ベース プ ロ フ ァ イル
OU=miami.OU=sales.O=sybase
68
PowerBuilder
第1章
•
DBParm パ ラ メ ー タ
DS_DitBase を
PowerBuilder ア プ リ ケーシ ョ ン の ス ク リ プ ト に指定す る には、 以
下の入力を行い ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
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
DS_Failover
機能
DS_Failover は、 PowerBuilder か ら Open Client を 経由 し て Sybase
Adaptive Server Enterprise デー タ ベース にア ク セ スす る と き に、 アプ リ
ケーシ ョ ン で ネ ッ ト ワ ー ク ベー ス のデ ィ レ ク ト リ サー ビ ス を 有効に
す る ために設定で き る DBParm パ ラ メ ー タ の う ちの 1 つです。 ほかの
デ ィ レ ク ト リ サービ ス DBParm パ ラ メ ー タ については、 以下の 「関連
項目」 を参照 し て く だ さ い。
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
フ ァ イ ル を使用す る よ う に指定 し ま す。
接続 リ フ ァ レ ン ス
69
DS_Failover
DS_Failover パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベース に接続す る
前に指定 し ま す。
サー ド パーテ ィ のデ ィ レ ク ト リ サー ビ ス プ ロバ イ ダの使用
Sybase が Open Client デ ィ レ ク ト リ サービ ス で テ ス ト を行っ たサー ド
パーテ ィ のデ ィ レ ク ト リ サー ビ ス プ ロ バ イ ダお よ びオペ レ ーテ ィ ン
グ シ ス テ ム プ ラ ッ ト フ ォーム の詳細については、Open Client の ド キ ュ
メ ン ト を参照 し て く だ さ い。
対象
SYC Sybase Adaptive Server Enterprise
構文
DS_Failover = value
パラ メ ー タ
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 DBParm の設定 DS_Failover を有効にす る には、 Release
DBParm パ ラ メ ー タ に '11'、 '11.5'、 '12'、 '12.5' のいずれか を設定 し て、
ア プ リ ケーシ ョ ン が適切なバージ ョ ン の Sybase Open Client
Client-Library （CT-Lib） の動作を使用す る こ と を指定す る 必要があ り
ま す。
70
PowerBuilder
第1章
DBParm パ ラ メ ー タ
使用のための要件 DS_Failover ま たは、Open Client デ ィ レ ク ト リ サー
ビ ス を サポー ト し てい る ほ かの DBParm パ ラ メ ー タ を使用す る には、
PowerBuilder ア プ リ ケーシ ョ ン でデ ィ レ ク ト リ サービ ス を使用す る た
め の 一定の 要件 を 満 た し て い る 必要が あ り ま す。 詳細 につい て は、
『デー タ ベー ス と の接続』 マ ニ ュ アルの 「Open Client のデ ィ レ ク ト リ
サービ ス を使用す る ための条件」 を参照 し て く だ さ い。
対応す る CT-Lib 接続プ ロ パテ ィ DS_Failover に値を指定する と 、
CS_DS_FAILOVER と い う 名前の、 対応す る Sybase CT-Lib 接続プ ロ パ
テ ィ が設定 さ れ ま す。
例
要求 さ れたデ ィ レ ク ト リ ド ラ イ バを ロ ー ド で き ない場合に、CT-Lib が
デ ィ レ ク ト リ ソ ー ス と し て Interfaces フ ァ イ ル を使用で き な い よ う に
す る には、 以下の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［デ ィ レ ク ト リ サービ ス ］ タ ブの ［フ ェ イ ル オーバーを有
効にす る ］ チ ェ ッ ク ボ ッ ク ス を オ フ に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に次の よ う に入力 し ま す。
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 デー タ ベース にア ク セ ス
す る と き に、 アプ リ ケーシ ョ ン でネ ッ ト ワ ー ク ベー ス のデ ィ レ ク ト リ
サービ ス を有効にす る ために設定で き る DBParm パ ラ メ ー タ の う ちの
1 つです。 ほかのデ ィ レ ク ト リ サービ ス DBParm パ ラ メ ー タ について
は、 以下の 「関連項目」 を参照 し て く だ さ い。
71
DS_Password
一部のデ ィ レ ク ト リ サービ ス プ ロ バ イ ダお よ び ド ラ イ バでは、認証 さ
れて い る プ リ ン シ プル （ユーザ ID） 名 と パ ス ワ ー ド で、 ア プ リ ケ ー
シ ョ ン に よ る デ ィ レ ク ト リ エ ン ト リ への ア ク セ ス を 制御す る こ と が
求 め ら れ ま す。 そ の よ う な プ ロ バ イ ダ お よ び ド ラ イ バ の 場 合 に、
DS_Principal と DS_Password は、 デ ィ レ ク ト リ サービ ス プ ロ バ イ ダに
ユーザ を識別 さ せ る ためにア プ リ ケーシ ョ ン が使用す る プ リ ン シプル
名 と パ ス ワ ー ド を指定 し ま す。
DS_Password DBParm の値は、 PowerBuilder か ら デー タ ベース に接続す
る 前に指定 し ま す。
対象
SYC Sybase Adaptive Server Enterprise
構文
DS_Password = 'password'
パラ メ ー タ
password
デフ ォル ト 値
説明
DS_Principal DBParm パ ラ メ ー タ で指定 し た プ リ ン シプル
名 （ユーザ ID） と 関係付け ら れてい る パ ス ワー ド
なし
値を指定 し ない場合、 DS_Password ま たは対応す る Sybase Open Client
Client-Library （CT-Lib） 接続パ ラ メ ー タ の CS_DS_PASSWORD は設定
さ れ ま せん。
解説
設定が必要な場合 デ ィ レ ク ト リ サー ビ ス プ ロ バ イ ダ がデ ィ レ ク ト
リ ア ク セ ス に対 し て認証 さ れ た プ リ ン シ プル名 を 要求す る 場合は、
DS_Password を、 デ ィ レ ク ト リ サービ ス のプ リ ン シプル名 と 一緒に使
う パ ス ワ ー ド に設定 し ま す。
Release DBParm を設定 DS_Password を有効にす る には、 Release
DBParm パ ラ メ ー タ に '12.5' を設定 し て、 ア プ リ ケーシ ョ ンが適切な
バージ ョ ン の Sybase Open Client Client-Library （CT-Lib） の動作を使用
す る こ と を指定す る 必要があ り ま す。
使用のための要件 DS_Password ま たは、 Open Client 12.5 デ ィ レ ク ト
リ サービ ス をサポー ト し てい る ほかの DBParm パ ラ メ ー タ を使用す る
には、 PowerBuilder ア プ リ ケーシ ョ ン でデ ィ レ ク ト リ サービ ス を使用
す る ための一定の要件を満た し てい る 必要があ り ま す。 詳細について
は、 『デー タ ベース と の接続』 マニ ュ アルの 「Open Client のデ ィ レ ク ト
リ サービ ス を使用す る ための条件」 を参照 し て く だ さ い。
対応す る CT-Lib 接続プ ロ パテ ィ DS_Password に 値 を 指 定 す る と 、
CS_DS_Password と い う 名前の、 対応す る Sybase CT-Lib 接続 プ ロ パ
テ ィ が設定 さ れ ま す。
例
ア プ リ ケーシ ョ ン のパ ス ワー ド と し て MYPASS を指定す る には、以下
の よ う に し ま す。
72
PowerBuilder
第1章
•
DBParm パ ラ メ ー タ
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［デ ィ レ ク ト リ サー ビ ス ］ タ ブの ［パ ス ワ ー ド ］ ボ ッ ク ス
で、 以下の入力を行い ま す。
デー タ ベース プ ロ フ ァ イル
MYPASS
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に次の よ う に入力 し ま す。
SQLCA.DBParm = "DS_Password = 'MYPASS'"
関連項目
DS_Alias
DS_Copy
DS_DitBase
DS_Failover
DS_Principal
DS_Provider
DS_TimeLimit
Release
DS_Principal
機能
DS_Principal は、 PowerBuilder か ら Open Client を 経由 し て Sybase
Adaptive Server Enterprise デー タ ベース にア ク セ スす る と き に、 アプ リ
ケーシ ョ ン で ネ ッ ト ワ ー ク ベー ス のデ ィ レ ク ト リ サー ビ ス を 有効に
す る ために設定で き る DBParm パ ラ メ ー タ の う ちの 1 つです。 ほかの
デ ィ レ ク ト リ サービ ス DBParm パ ラ メ ー タ については、 以下の 「関連
項目」 を参照 し て く だ さ い。
一部のデ ィ レ ク ト リ サービ ス プ ロ バ イ ダお よ び ド ラ イ バでは、認証 さ
れ て い る プ リ ン シ プル （ユーザ ID） 名で、 ア プ リ ケ ーシ ョ ン に よ る
デ ィ レ ク ト リ エ ン ト リ へのア ク セ ス を制御す る こ と が求め ら れ ま す。
そ の よ う な プ ロ バ イ ダ お よ び ド ラ イ バ の 場 合 に、 DS_Principal と
DS_Password は、 デ ィ レ ク ト リ サービ ス プ ロ バ イ ダにユーザ を識別 さ
せ る ためにアプ リ ケーシ ョ ン が使用す る プ リ ン シプル名 と パ ス ワ ー ド
を指定 し ま す。
DS_Principal DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー ス に
接続す る 前に指定 し ま す。
接続 リ フ ァ レ ン ス
73
DS_Principal
サー ド パーテ ィ のデ ィ レ ク ト リ サー ビ ス プ ロバ イ ダの使用
Sybase が Open Client デ ィ レ ク ト リ サービ ス で テ ス ト を行っ たサー ド
パーテ ィ のデ ィ レ ク ト リ サー ビ ス プ ロ バ イ ダお よ びオペ レ ーテ ィ ン
グ シ ス テ ム プ ラ ッ ト フ ォーム の詳細については、Open Client の ド キ ュ
メ ン ト を参照 し て く だ さ い。
対象
SYC Sybase Adaptive Server Enterprise
構文
DS_Principal = 'principal_name'
パラ メ ー タ
principal_name
デフ ォル ト 値
説明
デ ィ レ ク ト リ サー ビ ス プ ロ バ イ ダにユーザ を識別 さ せ る
ために アプ リ ケーシ ョ ン が使用す る プ リ ン シプル名
なし
値を指定 し ない場合、 DS_Principal ま たは対応す る Sybase Open Client
Client-Library （CT-Lib） 接続パ ラ メ ー タ の CS_DS_PRINCIPAL は設定
さ れ ま せん。
解説
設定が必要な場合 デ ィ レ ク ト リ サー ビ ス プ ロ バ イ ダ がデ ィ レ ク ト
リ ア ク セ ス に対 し て認証 さ れ た プ リ ン シ プル名 を 要求す る 場合は、
DS_Principal を、 デ ィ レ ク ト リ サービ ス のパ ス ワー ド と 一緒に使 う プ
リ ン シプル （ユーザ ID） 名に設定 し ま す。
Release DBParm の設定 DS_Principal を有効にす る には、 Release
DBParm パ ラ メ ー タ に '11'、 '11.5'、 '12'、 '12.5' のいずれか を設定 し て、
ア プ リ ケーシ ョ ン が適切なバージ ョ ン の Sybase Open Client
Client-Library （CT-Lib） の動作を使用す る こ と を指定す る 必要があ り
ま す。
使用のための要件 DS_Principal ま たは、 Open Client デ ィ レ ク ト リ
サービ ス を サポー ト し てい る ほかの DBParm パ ラ メ ー タ を使用す る に
は、 PowerBuilder アプ リ ケーシ ョ ン でデ ィ レ ク ト リ サービ ス を使用す
る ための一定の要件を満た し てい る 必要があ り ま す。 詳細について
は、 『デー タ ベース と の接続』 マニ ュ アルの 「Open Client のデ ィ レ ク
ト リ サービ ス を使用す る ための条件」 を参照 し て く だ さ い。
対応す る CT-Lib 接続プ ロ パテ ィ DS_Principal に値を指定す る と 、
CS_DS_PRINCIPAL と い う 名前の、 対応す る Sybase CT-Lib 接続プ ロ パ
テ ィ が設定 さ れ ま す。
例
ア プ リ ケーシ ョ ン のプ リ ン シ プル名 と し て JSMITH を指定す る には、
以下の よ う に し ま す。
74
PowerBuilder
第1章
•
DBParm パ ラ メ ー タ
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［デ ィ レ ク ト リ サービ ス ］ タ ブの ［主名］ ボ ッ ク ス で、 以
下の入力を行い ま す。
デー タ ベース プ ロ フ ァ イル
JSMITH
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に次の よ う に入力 し ま す。
SQLCA.DBParm = "DS_Principal = 'JSMITH'"
関連項目
DS_Alias
DS_Copy
DS_DitBase
DS_Failover
DS_Password
DS_Provider
DS_TimeLimit
Release
DS_Provider
機能
DS_Provider は、 PowerBuilder か ら Open Client を 経 由 し て Sybase
Adaptive Server Enterprise デー タ ベース にア ク セ スす る と き に、 アプ リ
ケーシ ョ ン で ネ ッ ト ワ ー ク ベー ス のデ ィ レ ク ト リ サー ビ ス を 有効に
す る ために設定で き る DBParm パ ラ メ ー タ の う ちの 1 つです。 ほかの
デ ィ レ ク ト リ サービ ス DBParm パ ラ メ ー タ については、 以下の 「関連
項目」 を参照 し て く だ さ い。
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 DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー ス に
接続す る 前に指定 し ま す。
接続 リ フ ァ レ ン ス
75
DS_Provider
サー ド パーテ ィ のデ ィ レ ク ト リ サー ビ ス プ ロバ イ ダの使用
Sybase が Open Client デ ィ レ ク ト リ サービ ス で テ ス ト を行っ たサー ド
パーテ ィ のデ ィ レ ク ト リ サー ビ ス プ ロ バ イ ダお よ びオペ レ ーテ ィ ン
グ シ ス テ ム プ ラ ッ ト フ ォーム の詳細については、Open Client の ド キ ュ
メ ン ト を参照 し て く だ さ い。
対象
SYC Sybase Adaptive Server Enterprise
構文
DS_Provider = 'provider_name'
パラ メ ー タ
provider_name
説明
デ ィ レ ク ト リ サービ ス に使用す る デ ィ レ ク ト リ サー ビ ス
プ ロ バ イ ダ名
プ ロ バ イ ダ名では大文字 と 小文字が区別 さ れ ま す。 Open
Client/Open Server Configuration ユ ー テ ィ リ テ ィ で表示 さ
れ る と お り に指定す る 必要が あ り ます。
デフ ォル ト 値
DS_Provider のデ フ ォ ル ト 値は、 Open Client/Open Server Configuration
ユ ーテ ィ リ テ ィ で現在 ア ク テ ィ ブ に指定 さ れ て い る プ ロ バ イ ダ 名で
す。
解説
設定が必要な場合 DS_Provider は、 デフ ォ ル ト の （ア ク テ ィ ブ な） プ
ロ バ イ ダ で ない、 Open Client/Open Server Configuration ユーテ ィ リ テ ィ
で指定 さ れ る デ ィ レ ク ト リ サー ビ ス プ ロ バ イ ダ を 使用す る 場合に設
定 し ま す。 Open Client/Open Server Configuration ユーテ ィ リ テ ィ の使い
方については、 Sybase Open Client/Server の 『設定ガ イ ド 』 マニ ュ アル
を参照 し て く だ さ い。
Release DBParm の設定 DS_Provider を有効にす る には、 Release
DBParm パ ラ メ ー タ に '11'、 '11.5'、 '12'、 '12.5' のいずれか を設定 し て、
ア プ リ ケーシ ョ ン が適切なバージ ョ ン の Sybase Open Client
Client-Library （CT-Lib） の動作を使用す る こ と を指定す る 必要があ り
ま す。
使用のための要件 DS_Provider ま たは、Open Client デ ィ レ ク ト リ サー
ビ ス を サポー ト し てい る ほか の DBParm パ ラ メ ー タ を使用す る には、
PowerBuilder ア プ リ ケーシ ョ ン でデ ィ レ ク ト リ サービ ス を使用す る た
め の一定 の要件 を 満 た し て い る 必要 が あ り ま す。 詳細 につい て は、
『デー タ ベー ス と の接続』 マ ニ ュ ア ルの 「Open Client のデ ィ レ ク ト リ
サービ ス を使用す る ための条件」 を参照 し て く だ さ い。
対応す る CT-Lib 接続プ ロ パテ ィ DS_Provider に値を指定す る と 、
CS_DS_PROVIDER と い う 名前の、 対応す る Sybase CT-Lib 接続プ ロ パ
テ ィ が設定 さ れ ま す。
76
PowerBuilder
第1章
例
DBParm パ ラ メ ー タ
デ ィ レ ク ト リ サービ ス プ ロ バ イ ダ名 と し て NTREGISTRY を指定す る
には、 以下の よ う に し ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［デ ィ レ ク ト リ サー ビ ス ］ タ ブの ［プ ロ バ イ ダ］ ボ ッ ク ス
で、 以下の入力を行い ま す。
デー タ ベース プ ロ フ ァ イル
NTREGISTRY
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に次の よ う に入力 し ま す。
SQLCA.DBParm = "DS_Provider = 'NTREGISTRY'"
関連項目
接続 リ フ ァ レ ン ス
DS_Alias
DS_Copy
DS_DitBase
DS_Failover
DS_Password
DS_Principal
DS_TimeLimit
Release
77
DS_TimeLimit
DS_TimeLimit
機能
DS_TimeLimit は、 PowerBuilder か ら Open Client を 経由 し て Sybase
Adaptive Server Enterprise デー タ ベース にア ク セ ス す る と き に、 アプ リ
ケーシ ョ ン でネ ッ ト ワ ー ク ベー ス のデ ィ レ ク ト リ サー ビ ス を有効に
す る ために設定で き る DBParm パ ラ メ ー タ の う ちの 1 つです。 ほかの
デ ィ レ ク ト リ サービ ス DBParm パ ラ メ ー タ については、「関連項目」 を
参照 し て く だ さ い。
一部のデ ィ レ ク ト リ サービ ス プ ロ バ イ ダお よ び ド ラ イ バは、デ ィ レ ク
ト リ 検索に対す る 時間制限の使用を サポー ト し て い ま す。 そのよ う な
ディ レ ク ト リ サービ ス プロ バイ ダおよ びド ラ イ バの場合、DS_TimeLimit
は、 デ ィ レ ク ト リ 検索を続行で き る 秒数を指定 し ま す。
デフ ォ ル ト では、 DS_TimeLimit は、 デ ィ レ ク ト リ 検索に対 し て時間制
限が設け ら れない よ う に し ま す。
DS_TimeLimit DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー ス
に接続す る 前に指定 し ま す。
サー ド パーテ ィ のデ ィ レ ク ト リ サー ビ ス プ ロバ イ ダの使用
Sybase が Open Client デ ィ レ ク ト リ サービ ス で テ ス ト を行っ たサー ド
パーテ ィ のデ ィ レ ク ト リ サー ビ ス プ ロ バ イ ダお よ びオペ レ ーテ ィ ン
グ シ ス テ ム プ ラ ッ ト フ ォーム の詳細については、Open Client の ド キ ュ
メ ン ト を参照 し て く だ さ い。
対象
SYC Sybase Adaptive Server Enterprise
構文
DS_TimeLimit = 'value'
パラ メ ー タ
value
説明
デ ィ レ ク ト リ 検索 を続行で き る 秒数 を指定す る 値。 ま た、
'no_limit' （デ フ ォ ル ト ） を 指定す る と 、 デ ィ レ ク ト リ
検索に時間制限が設定 さ れない よ う にす る こ と も で き ま
す。
指定 し た時間が経過 し た場合、お よ び検索対象が見つか ら
な か っ た 場 合 は、 デ ィ レ ク ト リ 検 索 は 成 功 せ ず、
PowerBuilder の接続は解除 さ れ ます。
デフ ォル ト 値
78
DS_TimeLimit = 'no_limit'
PowerBuilder
第1章
解説
DBParm パ ラ メ ー タ
Release DBParm の設定 DS_TimeLimit を有効にす る には、 Release
DBParm パ ラ メ ー タ に '11'、 '11.5'、 '12'、 '12.5' のいずれか を設定 し て、
ア プ リ ケーシ ョ ンが適切なバージ ョ ンの Sybase Open Client
Client-Library （CT-Lib） の動作を使用す る こ と を指定す る 必要があ り
ま す。
使用のための要件 DS_TimeLimit ま た は、 Open Client デ ィ レ ク ト リ
サービ ス を サポー ト し てい る ほかの DBParm パ ラ メ ー タ を使用す る に
は、 PowerBuilder アプ リ ケーシ ョ ン でデ ィ レ ク ト リ サービ ス を使用す
る ための一定の要件を満た し てい る 必要があ り ま す。詳細については、
『デー タ ベー ス と の接続』 マ ニ ュ アルの 「Open Client のデ ィ レ ク ト リ
サービ ス を使用す る ための条件」 を参照 し て く だ さ い。
対応す る CT-Lib 接続プ ロ パテ ィ DS_TimeLimit に 値 を 指定 す る と 、
CS_DS_TIMELIMIT と い う 名前の、対応す る Sybase CT-Lib 接続プ ロ パ
テ ィ が設定 さ れ ま す。
例
デ ィ レ ク ト リ 検索を 最長で 120 秒 （2 分） 間続行で き る よ う に指定す
る には、 以下の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［デ ィ レ ク ト リ サー ビ ス ］ タ ブの ［デ ィ レ ク ト リ 検索時間
の最大値］ ボ ッ ク ス に 120 と 入力 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に以下を入力 し ま す。
SQLCA.DBParm = "DS_TimeLimit = 120"
関連項目
DS_Alias
DS_Copy
DS_DitBase
DS_Failover
DS_Password
DS_Principal
DS_Provider
Release
EncryptPassword
機能
接続 リ フ ァ レ ン ス
OLE DB デー タ プ ロ バ イ ダに接続す る と き に、 PowerBuilder が自動的
にパ ス ワ ー ド を暗号化す る か ど う か を指定 し ま す。
79
FoDelay
EncryptPassword を指定す る タ イ ミ ン グ
EncryptPassword DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー
ス に接続す る 前に指定 し ま す。
対象
OLE DB
構文
EncryptPassword = 'value'
パラ メ ー タ
value
説明
PowerBuilder がパ ス ワ ー ド を 暗号化す る か ど う か を 指定
す る 値。 以下のいずれかの値を指定 し ま す。
• True PowerBuilder がパ ス ワ ー ド を暗号化 し ます。
• False （デフ ォ ル ト ） PowerBuilder はパ ス ワ ー ド を暗号
化 し ません。
デフ ォル ト 値
EncryptPassword = 'False'
例
OLE DB デー タ プ ロ バ イ ダに接続す る と き に、PowerBuilder にパ ス ワ ー
ド を暗号化 さ せ る には、 以下の操作を行い ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［セ キ ュ リ テ ィ ］ タ ブ の ［パ ス ワ ー ド の暗号化］ チ ェ ッ ク
ボ ッ ク ス を オ ン に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で以下の入力を行い ま す。
アプ リ
SQLCA.dbParm = "EncryptPassword='True'"
関連項目
DataLink
IntegratedSecurity
MaskPassword
PersistEncrypted
FoDelay
機能
現行のデー タ ベー ス サーバが ダ ウ ン し た場合に PowerBuilder が別の
デー タ ベー ス サーバへの フ ェ イ ルオーバ を 試み る ま で待機す る 時間
（ ミ リ 秒単位） を指定 し ま す。
FoDelay を指定する タ イ ミ ン グ
FoDelay DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー ス に接続
す る 前に指定 し ま す。
80
PowerBuilder
第1章
DBParm パ ラ メ ー タ
対象
O84 Oracle 8.x お よ び Oracle8i （8.1.5 以降のデー タ ベース 接続のみ）
O90 Oracle9i
構文
FoDelay = 'value'
パラ メ ー タ
value
説明
PowerBuilder が 別 の デー タ ベー ス サ ー バ へ の フ ェ イ ル
オーバ を試み る ま で待機す る時間 （ ミ リ 秒単位） を指定 し
ます。
デ フ ォル ト 値
FoDelay = '10'
解説
フ ェ イ ルオーバの遅延の値は、 フ ェ イ ルオーバ を有効に し てい る 場合
にのみ入力可能です。
こ のパ ラ メ ー タ は、 動的設定にで き ま せん。 接続の確立時に設定 さ れ
た値は、 接続が切断す る ま で有効です。
例
PowerBuilder が フ ェ イ ルオーバを試み る ま で 20 ミ リ 秒待機す る よ う 指
定す る には、 以下の操作を行い ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ネ ッ ト ワ ー ク ］ タ ブの ［ リ ト ラ イ 間隔］ ボ ッ ク ス に 20 と
入力 し ま す。
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
デー タ ベース プ ロ フ ァ イル
PowerBuilder ス ク リ プ
ト に以下を入力 し ま す。
SQLCA.DBParm = "FoDelay = '20'"
関連項目
SvrFailover
FoDialog
機能
フ ェ イ ルオーバの実行条件 を 指示す る 実行時 ダ イ ア ロ グ ボ ッ ク ス を
表示す る か ど う か を指定 し ま す。
FoDialog を指定する タ イ ミ ン グ
FoDialog DBParm パ ラ メ ー タ は、PowerBuilder か ら デー タ ベー ス に接続
す る 前に指定 し ま す。
対象
O84 Oracle 8.x お よ び Oracle8i （8.1.5 以降のデー タ ベース 接続のみ）
O90 Oracle9i
構文
FoDialog = 'value'
接続 リ フ ァ レ ン ス
81
FoRetryCount
パラ メ ー タ
value
説明
フ ェ イ ルオーバの実行条件 を指示す る 実行時 ダ イ ア ロ グ
ボ ッ ク ス を表示す る か ど う か を指定 し ます。以下のいずれ
かの値を指定 し ます。
• No （デフ ォ ル ト ） ダ イ ア ロ グボ ッ ク ス が表示 さ れない
よ う に指定 し ま す。
• Yes ダ イ ア ロ グ ボ ッ ク ス が表示 さ れ る よ う に指定 し ま
す。
デフ ォル ト 値
FoDialog = 'No'
解説
実行時 ダ イ ア ロ グ ボ ッ ク ス は、 フ ェ イ ルオーバを有効に し てい る 場合
にのみ表示可能です。
こ のパ ラ メ ー タ は、 動的設定にで き ま せん。 接続の確立時に設定 さ れ
た値は、 接続が切断す る ま で有効です。
例
フ ェ イ ルオーバの際に実行時 ダ イ ア ロ グ ボ ッ ク ス が表示 さ れ る よ う
に指定す る には、 以下の操作を行い ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ネ ッ ト ワ ー ク ］ タ ブで、 ［ フ ェ イ ルオーバー時にダ イ ア ロ
グ を表示］ チ ェ ッ ク ボ ッ ク ス を オ ン に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に以下を入力 し ま す。
SQLCA.DBParm = "FoDialog = 'Yes'"
関連項目
SvrFailover
FoRetryCount
機能
現行のデー タ ベー ス サーバが ダ ウ ン し た場合に PowerBuilder が別の
デー タ ベース サーバへの フ ェ イ ルオーバ を試み る 回数を指定 し ま す。
FoRetryCount を指定す る タ イ ミ ン グ
FoRetryCount DBParm パ ラ メ ー タ は、PowerBuilder か ら デー タ ベース に
接続す る 前に指定 し ま す。
対象
O84 Oracle 8.x お よ び Oracle8i （8.1.5 以降のデー タ ベース 接続のみ）
O90 Oracle9i
構文
FoRetryCount = 'value'
82
PowerBuilder
第1章
パラ メ ー タ
value
DBParm パ ラ メ ー タ
説明
フ ェ イ ルオーバの試行回数 を指定 し ます。
デ フ ォル ト 値
FoRetryCount = '10'
解説
フ ェ イ ルオーバの試行回数は、 フ ェ イ ルオーバ を有効に し てい る 場合
にのみ入力可能です。
こ のパ ラ メ ー タ は、 動的設定にで き ま せん。 接続の確立時に設定 さ れ
た値は、 接続が切断す る ま で有効です。
例
PowerBuilder に フ ェ イ ルオーバを 20 回試行 さ せ る には、 以下の操作を
行い ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ネ ッ ト ワ ー ク ］ タ ブ で、 ［ リ ト ラ イ 回数］ ボ ッ ク ス に 20
を入力 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に以下を入力 し ま す。
SQLCA.DBParm = "FoRetryCount = '20'"
関連項目
SvrFailover
FormatArgsAsExp
機能
デー タ ウ ィ ン ド ウ ま たは レ ポー ト の Decimal デー タ 型の検索引数が 13
～ 15 桁の と き に、 PowerBuilder がその引数を指数表記に変換す る か ど
う か を制御 し ま す。 FormatArgsAsExp が Yes （デフ ォ ル ト ） に設定 さ れ
てい る 場合、 PowerBuilder は こ の変換を実行 し ま す。
FormatArgsAsExp を指定す る タ イ ミ ン グ
FormatArgsAsExp の値は、PowerBuilder か ら デー タ ベー ス に接続す る 前
に指定 し ま す。
対象
JDB JDBC
ODBC イ ン タ フ ェー ス
O73 Oracle 7.3
O84 Oracle 8.x お よ び Oracle8i
O90 Oracle9i
SYC お よ び SYJ Sybase Adaptive Server Enterprise
構文
FormatArgsAsExp= 'value'
接続 リ フ ァ レ ン ス
83
FormatArgsAsExp
パラ メ ー タ
value
説明
デー タ ウ ィ ン ド ウ ま たは レ ポー ト の Decimal デー タ 型の
検索引数が 13 ～ 15 桁の と き に、 PowerBuilder がその引数
を指数表記に変換す る か ど う か を指定 し ま す。以下のいず
れかの値を指定 し ま す。
• Yes 検索引数が 13 ～ 15 桁の場合、 Decimal デー タ 型
を指数表記に変換 し ます。
• No （デ フ ォ ル ト ） 検索引数が 13 ～ 15 桁の場合で も
Decimal 型の ま ま に し 、 指数表記へのデ フ ォ ル ト 変換 を
実行 し ません。
デフ ォル ト 値
FormatArgsAsExp = 'No'
解説
設定が必要な場合 FormatArgsAsExp の設定値は、 特に大規模なデー
タ ベー ス に ア ク セ ス す る 場合に、 デー タ ウ ィ ン ド ウ と レ ポ ー ト で の
デー タ 検索の処理速度に影響を与え る こ と があ り ま す。
FormatArgsAsExp が Yes に設定 さ れてい る 場合、 PowerBuilder は 13 ～
15 桁の Decimal 型の検索引数を指数表記に変換 し ま す。 一部の DBMS
オプ テ ィ マ イ ザは、結果の指数表記を別のデー タ 型 と し て解釈 し 、テー
ブル内のすべての行を ス キ ャ ン し てそのデー タ 型を見つけ よ う と し ま
す。 こ の処理の際には、た と えば、大 き な テーブルが多数あ る DB2 デー
タ ベー ス にア ク セ ス し てい る 場合、 デー タ 検索の速度が遅 く な る 可能
性があ り ま す。
FormatArgsAsExp を No に 設 定 す る と 、 PowerBuilder は 検索 引 数 を
Decimal の ま ま に し 、 指数表記への変換を行い ま せん。 こ のため、 大規
模なデー タ ベー ス でのデー タ 検索を速 く 処理で き ま す。
検索引数のサ イズの制限
Decimal 型 の 検索引数 が 16 桁未満 の 場合 に 限 り 、 FormatArgsAsExp
DBParm を使用 し ま す。
例
13 ～ 15 桁の検索引数が指数表記に変換 さ れ る よ う に指定す る には、以
下の操作を行い ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［構文］ タ ブで、 ［指数表記で表示］ チ ェ ッ ク ボ ッ ク ス を オ
ン に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に以下を入力 し ま す。
SQLCA.DBParm = "FormatArgsAsExp = 'Yes'"
84
PowerBuilder
第1章
DBParm パ ラ メ ー タ
GetConnectionOption
機能
キ ャ ッ シ ュ 内のすべて の接続が使用 さ れて い る 場合の EAServer の動
作 を 指定 す る 値。 こ の DBParm パ ラ メ ー タ が 適 用 さ れ る の は、
PowerBuilder カ ス タ ム ク ラ ス ユーザ オ ブ ジ ェ ク ト が EAServer コ ン
ポーネ ン ト と し て配布 さ れ る 場合だけです。
対象
JDB JDBC
ODBC
O73 Oracle 7.3
O84 Oracle 8.x お よ び Oracle8i
O90 Oracle9i
SYJ Sybase Adaptive Server Enterprise
構文
GetConnectionOption = 'value'
パラ メ ー タ
value
説明
キ ャ ッ シ ュ 内 の すべ て の 接続 が 使 用 さ れ て い る 場合 の
EAServer の動作を指定す る 値。以下のいずれかの値を指定
し ます。
• JAG_CM_FORCE （デフ ォ ル ト ） 新 し い接続を割 り 当て
て開 き ます。 新 し い接続はキ ャ ッ シ ュ さ れず、接続が明
示的 ま たは暗黙的に コ ン ポーネ ン ト に よ っ て閉 じ ら れ
る と き に割 り 当てが解除 さ れ ます。
• JAG_CM_NOWAIT 接続 を 確立 で き な い 場合は エ ラ ー
を生成 し て失敗 し ます。
• JAG_CM_WAIT 接続が利用可能に な る ま で結果 を返 し
ません。
デ フ ォル ト 値
GetConnectionOption = 'JAG_CM_FORCE'
解説
こ のパ ラ メ ー タ は、 動的に設定す る こ と がで き ま せん。 接続の確立時
に設定 さ れた値は、 接続が切断す る ま で有効です。
接続 リ フ ァ レ ン ス
85
Host
SYJ イ ン タ フ ェ ースの使用
Sybase EAServer は、 わずかに異な る バージ ョ ン の CT-Lib ソ フ ト ウ ェ
ア を使用 し ま す。 し たが っ て、実行時に、Adaptive Server Enterprise デー
タ ベ ー ス に 接続す る に は SYC で は な く SYJ デー タ ベー ス イ ン タ
フ ェ ース を使用す る 必要が あ り ま す。 SYJ の DB プ ロ フ ァ イ ル設定 ダ
イ ア ロ グ ボ ッ ク ス を使用す る と 、 適切な接続パ ラ メ ー タ を設定 し 、 構
文を ［プ レ ビ ュ ー］ タ ブか ら ト ラ ン ザ ク シ ョ ン オブジ ェ ク ト の ス ク リ
プ ト に コ ピ ーで き ま す。
ただ し 、 PowerBuilder 開発環境か ら デー タ ベー ス に接続す る 場合には
SYJ イ ン タ フ ェ ー ス を 使用で き ま せん。 し たが っ て、 開発段階で （ コ
ン ポーネ ン ト が EAServer に配布 さ れ る 前に）、 SYC を使用 し てデー タ
ベース に接続す る 必要があ り ま す。
PowerBuilder を使用 し て EAServer コ ン ポーネ ン ト を作成す る 方法につ
いては、 『ア プ リ ケーシ ョ ン テ ク ニ ッ ク 』 マニ ュ ア ルを 参照 し て く だ
さ い。
例
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク ス の ［EAServer］ タ ブで、 ［接
続取得オプ シ ョ ン］ ド ロ ッ プダ ウ ン リ ス ト の 「JAG_CM_NOWAIT」 を
選択 し ま す。 GetConnectionOption DBParm パ ラ メ ー タ の PowerScript 構
文が、 次の よ う に ［プ レ ビ ュ ー］ タ ブに表示 さ れ ま す。
SQLCA.dbParm = "GetConnectionOption = 'JAG_CM_NOWAIT'"
こ の構文を ［プ レ ビ ュ ー］ タ ブか ら ス ク リ プ ト に コ ピー し ま す。
関連項目
CacheName
ReleaseConnectionOption
UseContextObject
Host
機能
86
PowerBuilder か ら デー タ ベー ス に接続す る と き に、 接続す る ワ ー ク ス
テーシ ョ ン名を指定 し ま す。 ただ し 、 DBMS が こ れを サポー ト し てい
る 場合に限 り ま す。 Host DBParm パ ラ メ ー タ には、 デー タ ベー ス への
接続時に作成 さ れ る プ ロ セ ス を識別す る ための、 10 文字以内の ラ ベル
を設定で き ま す。 こ の ラ ベルに よ っ て、 デー タ ベー ス サーバ上で稼働
し てい る ほかのプ ロ セ ス と 、 自分のプ ロ セ ス を区別で き ま す。
PowerBuilder
第1章
DBParm パ ラ メ ー タ
Host を指定する タ イ ミ ン グ
Host DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー ス に接続す
る 前に指定 し ま す。
対象
MSS Microsoft SQL Server
SYC Sybase Adaptive Server Enterprise
構文
Host = 'workstation_name'
デ フ ォル ト 値
なし
解説
Host パ ラ メ ー タ の値を指定す る と 、PowerBuilder に よ っ て、SQL Server
CS_HOSTNAME 接続プ ロ パテ ィ に、指定 し た ワ ー ク ス テーシ ョ ン名が
設定 さ れ ま す。
指定 し た Host パ ラ メ ー タ の 値 は、 SQL Server デー タ ベー ス の 中 の
MASTER.DBO.SYSPROCESSES テーブルの、Hostname カ ラ ム に表示 さ
れ ま す。 Host パ ラ メ ー タ の使い方は、 PowerBuilder のア プ リ ケーシ ョ
ン の設計方法に よ っ て異な り ま す。
た と えば、 サ イ ト で使用す る テーブルのセキ ュ リ テ ィ を守 る ため、 特
定のア プ リ ケーシ ョ ン か ら のア ク セ ス に限っ て更新 さ れ る も の と し ま
す。 こ のためには、エ ン ド ユーザではな く 、PowerBuilder のア プ リ ケー
シ ョ ン に対 し て明示的な権限を与え ま す。 ア プ リ ケーシ ョ ン は、 エ ン
ド ユーザに対 し て認証用の ID やパ ス ワ ー ド の入力を求め、 こ れ を確
認 し てか ら 、特別な ア プ リ ケーシ ョ ン ロ グ イ ン ID を介 し て SQL Server
デー タ ベー ス に接続 し ま す。 こ の ア プ リ ケーシ ョ ン ロ グ イ ン ID だ け
が、 テーブルを更新す る 権限を持ち ま す。
こ の例の場合、 Host DBParm パ ラ メ ー タ を使用 し て、 ア プ リ ケーシ ョ
ン を稼働 し てい る エ ン ド ユーザの名前を格納で き ま す。
例
例1
•
ホ ス ト 名を Alan に設定す る には、 以下の操作を行い ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ネ ッ ト ワ ー ク ］ タ ブで、 ［ ワー ク ス テーシ ョ ン名］ ボ ッ ク
ス に次の よ う に入力 し ま す。
デー タ ベース プ ロ フ ァ イル
Alan
•
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で以下の入力を行い ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "Host = 'Alan'"
接続 リ フ ァ レ ン ス
87
IdentifierQuoteChar
AppName パ ラ メ ー タ と Host パ ラ メ ー タ を一緒に指定す る こ と に
よ っ て、 アプ リ ケーシ ョ ン名 と ホ ス ト 名の両方を指定で き ま す。 ホ ス
ト 名を Jane に、 ア プ リ ケーシ ョ ン名を Sales に設定す る には、 以下の
操作を行い ま す。
例2
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ネ ッ ト ワ ー ク ］ タ ブで、 ［ ワー ク ス テーシ ョ ン名］ ボ ッ ク
ス に Jane、 ［ア プ リ ケーシ ョ ン名］ ボ ッ ク ス に Sales と 入力 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で以下の入力を行い ま す。
アプ リ
SQLCA.dbParm = "Host = 'Jane',AppName = 'Sales'"
関連項目
AppName
IdentifierQuoteChar
機能
SQL 文を作成す る と き に、 識別子 （テーブル、 カ ラ ム、 イ ンデ ッ ク ス 、
制約） の名前の区切 り 記号 と し て使用す る 、 単一引用符文字を指定 し
ま す。 PowerBuilder は、 ド ラ イ バ ま たはデー タ プ ロ バ イ ダか ら 返 さ れ
る デフ ォ ル ト の引用符文字ではな く 、 指定 さ れた引用符文字を使用 し
ま す。
DelimitIdentifier を Yes に設定する
IdentifierQuoteChar パ ラ メ ー タ の設定を有効にす る ためには、
DelimitIdentifier パ ラ メ ー タ を Yes に設定 し ま す。 こ の設定がない と 、
PowerBuilder はデフ ォ ル ト で、 SQL 文の中の識別子を区切 り ま せん。
ま た、 IdentifierQuoteChar パ ラ メ ー タ に指定 し た値を無視 し ま す。
対象
JDB JDBC
ODBC（ ド ラ イ バお よ びバ ッ ク エ ン ド DBMS がサポー ト し てい る 場合）
OLE DB
構文
IdentifierQuoteChar = 'quote_character'
パラ メ ー タ
quote_character
デフ ォル ト 値
88
説明
SQL 文の中で識別子の名前を区切 る ために使用す る 1 つ
の文字。 こ の文字が、 ド ラ イ バ ま たはデー タ プ ロ バ イ ダ
のデ フ ォ ル ト の引用符文字に代わ っ て使用 さ れ ます。
なし
PowerBuilder
第1章
DBParm パ ラ メ ー タ
PowerBuilder は、 以下の順序で検索を実行 し 、 IdentifierQuoteChar 値を
決定 し ま す。
1
使用 し てい る デー タ ベース プ ロ フ ァ イ ルに対応す る PowerBuilder
初期設定フ ァ イ ルの中のセ ク シ ョ ン （開発環境の場合）、 ま たはト
ラ ン ザク ショ ン オブジェ ク ト DBParm プロ パティ の値 （PowerBuilder
ア プ リ ケーシ ョ ンの場合）
2
使用 し てい る ODBC ド ラ イ バに対応す る 、PBODB90 初期設定フ ァ
イ ルの中のセ ク シ ョ ン、 ま たは使用 し てい る JDBC ド ラ イ バに対
応す る 、 レ ジ ス ト リ の中のセ ク シ ョ ン
こ れ ら の場所で IdentifierQuoteChar 値が見つか ら ない場合、 ド ラ イ バ
に対 し て SQLGetInfo が呼び出 さ れ、 デフ ォ ル ト の
SQL_IDENTIFIER_QUOTE_CHAR 値が返 さ れ ま す。
OLE DB イ ン タ フ ェ ース を使用する場合
IdentifierQuoteChar DBParm パ ラ メ ー タ に値が指定 さ れ てい な い場合、
引用符文字は使用 さ れ ま せん。
解説
一部の ド ラ イ バはデフ ォ ル ト で、 バ ッ ク ク ォ ー ト （`） な ど の文字を、
引用符文字 と し て返 し ま す。こ れ を PowerBuilder では判別で き ま せん。
こ の結果、 PowerBuilder において、 こ れ ら の ド ラ イ バの区切 り 記号が
無効にな り ま す。
し か し 、 区切 り 記号を必要 と す る 識別子があ る SQL 文を使用 し て、 そ
の区切 り 記号が無効 と な っ てい る ド ラ イ バを使用 し た場合に、 構文エ
ラ ーが発生す る 恐れが あ り ま す。 こ の よ う な エ ラ ー を防 ぐ た めには、
IdentifierQuoteChar パ ラ メ ー タ を設定 し て、 ド ラ イ バのデフ ォ ル ト の引
用符文字を使用 し ない よ う に し ま す。
例
SQL 文の中で識別子を区切 る 引用符文字 と し て c が使用 さ れ る よ う に
指定す る には、 以下の操作を行い ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［構文］ タ ブで、 ［識別子の引用記号］ ボ ッ ク ス に c と 入力
し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "IdentifierQuoteChar = 'c'"
関連項目
接続 リ フ ァ レ ン ス
DelimitIdentifier
89
ImpersonationLevel
ImpersonationLevel
機能
デー タ サーバが OLE DB デー タ プ ロ バ イ ダお よ び PowerBuilder の イ
ン パー ソ ネーシ ョ ン （偽装） を行 う と き に使用で き る イ ン パー ソ ネー
シ ョ ン レ ベル を指定 し ま す。 こ の DBParm は、 Remote Procedure Call
（RPC） 接続以外のネ ッ ト ワー ク 接続だけに適用 さ れ ま す。
ImpersonationLevel を指定する タ イ ミ ン グ
ImpersonationLevel DBParm パ ラ メ ー タ は、 PowerBuilder か ら デ ー タ
ベース に接続す る 前に指定 し ま す。
対象
OLE DB
構文
ImpersonationLevel = 'value'
パラ メ ー タ
value
説明
イ ン パー ソ ネーシ ョ ン レ ベル を指定す る 値。 以下のいずれか
の値を指定 し ます。
• Not set ど の レ ベルの イ ン パー ソ ネー シ ョ ン も 選択 さ れ ま
せん。
• Anonymous ク ラ イ ア ン ト はサーバ に対 し て匿名 で あ り 、
サーバ プ ロ セ ス は ク ラ イ ア ン ト についての識別情報を取得
で き ず、 ク ラ イ ア ン ト の イ ン パー ソ ネーシ ョ ン を行 う こ と
がで き ま せん。
• Delegate プ ロ セ ス は、 ク ラ イ ア ン ト の セ キ ュ リ テ ィ コ ン
テ キ ス ト の イ ン パー ソ ネーシ ョ ン が で き 、 ク ラ イ ア ン ト の
かわ り に動作で き ま す。 ま た、 サーバ プ ロ セ ス は ク ラ イ ア
ン ト に代わ っ てほかのサーバへの呼び出 し が行え ます。
• Identify サーバは ク ラ イ ア ン ト の ID を取得で き ます。 サー
バ は ACL チ ェ ッ ク 用 の ク ラ イ ア ン ト を イ ン パ ー ソ ネ ー
シ ョ ン で き ま すが、 シ ス テ ム オブジ ェ ク ト に ク ラ イ ア ン ト
と し て ア ク セ スす る こ と はで き ません。
• Impersonate サーバ プ ロ セ ス は、 ク ラ イ ア ン ト のセ キ ュ リ
テ ィ コ ン テ キ ス ト の イ ンパー ソ ネーシ ョ ンがで き 、 ク ラ イ
ア ン ト のかわ り に動作で き ます。 こ の情報は、呼び出 し ご と
ではな く 、 接続が確立 さ れた と き に取得 さ れ ます。
デフ ォル ト 値
ImpersonationLevel = 'Not set'
例
イ ンパー ソ ネーシ ョ ン レベルを anonymous に設定す る には、 以下の操
作を行い ます。
•
90
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［セキ ュ リ テ ィ ］ タ ブで、 ［ イ ンパー ソ ネーシ ョ ン レベル］
ド ロ ッ プ ダ ウ ン リ ス ト の 「Anonymous」 を選択 し ま す。
デー タ ベース プ ロ フ ァ イル
PowerBuilder
第1章
DBParm パ ラ メ ー タ
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
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
•
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "INET_DBPATH = '/home/Informix'"
例 2 INET_DBPATH、 INET_PROTOCOL、 INET_SERVICE の値は、 一
緒に指定で き ま す。 /Informix と い う デ ィ レ ク ト リ に Informix デー タ
ベー ス を格納 し 、 SE9 サービ ス と TCP/IP ネ ッ ト ワ ー ク プ ロ ト コ ル を
使用 し て接続す る よ う に指定す る には、 以下の操作を行い ま す。
接続 リ フ ァ レ ン ス
91
INET_PROTOCOL
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ネ ッ ト ワ ー ク ］ タ ブで、［DB パ ス ］ ボ ッ ク ス に /Informix、
［サー ビ ス 名］ ボ ッ ク ス に SE9、 ［プ ロ ト コ ルの種類］ ボ ッ ク ス に
tcp-ip と 入力 し ま す。
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
デー タ ベース プ ロ フ ァ イル
PowerBuilder ア プ リ
ケーシ ョ ン ス ク リ プ ト に、 次の ス テー ト メ ン ト を 1 行で入力 し ま
す。
SQLCA.dbParm = "INET_DBPATH = '/Informix',
INET_SERVICE = 'se9',INET_PROTOCOL = 'tcpip'"
関連項目
INET_PROTOCOL
INET_SERVICE
INET_PROTOCOL
機能
Informix ク ラ イ ア ン ト ソ フ ト ウ ェ ア が リ モー ト の Informix Version 9.x
デー タ ベース サーバ と の通信に使用す る 、ネ ッ ト ワ ー ク プ ロ ト コ ルを
指定 し ま す。
対象
IN9 Informix
構文
INET_PROTOCOL = 'network_protocol '
パラ メ ー タ
network_protocol
説明
Informix ク ラ イ ア ン ト ソ フ ト ウ ェ アが使用す る ネ ッ ト
ワ ー ク プ ロ ト コ ルの名前を表す文字列
サ イ ト で使用で き る 適切 な ネ ッ ト ワ ー ク プ ロ ト コ ル
につい ては、 Informix シ ス テ ム管理者に問い合わせて
く だ さ い。
デフ ォル ト 値
デ フ ォ ル ト では、 Informix.INI コ ン フ ィ グ レ ーシ ョ ン フ ァ イ ルの中で
指定 さ れてい る ネ ッ ト ワ ー ク プ ロ ト コ ルが使用 さ れ ま す。
例
例1
92
Informix ク ラ イ ア ン ト ソ フ ト ウ ェ ア が Novell IPX/SPX ネ ッ ト
ワ ー ク プ ロ ト コ ルを使用す る よ う に指定す る には、 以下の操作を行い
ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ネ ッ ト ワ ー ク ］ タ ブで、 ［プ ロ ト コ ルの種類］ ボ ッ ク ス に
ipx と 入力 し ま す。
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
デー タ ベース プ ロ フ ァ イル
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
PowerBuilder
第1章
DBParm パ ラ メ ー タ
SQLCA.dbParm = "INET_PROTOCOL = 'ipx'"
例 2 INET_DBPATH、 INET_PROTOCOL、 INET_SERVICE の値は、 一
緒に指定で き ま す。 /Informix と い う デ ィ レ ク ト リ に Informix デー タ
ベー ス を格納 し 、 SE9 サービ ス と TCP/IP ネ ッ ト ワ ー ク プ ロ ト コ ル を
使用 し て接続す る よ う に指定す る には、 以下の操作を行い ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ネ ッ ト ワ ー ク ］ タ ブで、 ［DB パ ス ］ ボ ッ ク ス に /Informix、
［サー ビ ス 名］ ボ ッ ク ス に SE9、 ［プ ロ ト コ ルの種類］ ボ ッ ク ス に
tcp-ip と 入力 し ま す。
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
デー タ ベース プ ロ フ ァ イル
PowerBuilder ア プ リ
ケーシ ョ ン ス ク リ プ ト に、 次の ス テー ト メ ン ト を 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 と い う ネ ッ ト ワ ー ク プ ロ
ト コ ルを使用す る よ う に指定す る には、 以下の操作を行い ま す。
93
Init_Prompt
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ネ ッ ト ワ ー ク ］ タ ブ の ［プ ロ ト コ ルの種類］ ボ ッ ク ス に
sqlexec と 入力 し ま す。
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
デー タ ベース プ ロ フ ァ イル
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "INET_SERVICE = 'sqlexec'"
INET_DBPATH、 INET_PROTOCOL、 INET_SERVICE の値は、 一
緒に指定で き ま す。 /Informix と い う デ ィ レ ク ト リ に Informix デー タ
ベー ス を格納 し 、 SE9 サービ ス と TCP/IP ネ ッ ト ワ ー ク プ ロ ト コ ル を
使用 し て接続す る よ う に指定す る には、 以下の操作を行い ま す。
例2
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ネ ッ ト ワー ク ］ タ ブで、 ［DB パ ス ］ ボ ッ ク ス に /informix、
［サービ ス 名］ ボ ッ ク ス に SE9、 ［プ ロ ト コ ルの種類］ ボ ッ ク ス に
tcp-ip と 入力 し ま す。
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
デー タ ベース プ ロ フ ァ イル
PowerBuilder ア プ リ
ケーシ ョ ン ス ク リ プ ト に、 次の ス テー ト メ ン ト を 1 行で入力 し ま
す。
SQLCA.dbParm = "INET_DBPATH = '/Informix',
INET_SERVICE = 'se9',INET_PROTOCOL = 'tcp-ip'"
関連項目
INET_DBPATH
INET_PROTOCOL
Init_Prompt
機能
初期化時にプ ロ ン プ ト を表示す る か ど う か を指定す る 値。
Init_Prompt を指定する タ イ ミ ン グ
Init_Prompt DBParm パ ラ メ ー タ は、PowerBuilder か ら デー タ ベース に接
続す る 前に指定 し ま す。
対象
OLE DB
構文
Prompt = 'value'
94
PowerBuilder
第1章
パラ メ ー タ
value
DBParm パ ラ メ ー タ
説明
初期化時にプ ロ ンプ ト を表示す る か ど う か を指定す る値。以下
のいずれかの値 を指定 し ます。
• Not set プ ロ ン プ ト は表示 さ れ ません。
• Always 初期化情報のプ ロ ン プ ト が常に表示 さ れ ます。
• If needed 追加情報が必要な場合だ け プ ロ ン プ ト が表示 さ
れます。
デ フ ォル ト 値
Init_Prompt = 'Not set'
例
初期化時にプ ロ ン プ ト が常に表示 さ れ る よ う にす る には、 以下の操作
を行い ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［シ ス テ ム］ タ ブで、 ［プ ロ ン プ ト ］ ド ロ ッ プ ダ ウ ン リ ス ト
の 「Always」 を選択 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
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 に設
定 し ます。
接続 リ フ ァ レ ン ス
95
InsertBlock
デフ ォル ト 値
InsertBlock = 100
解説
InsertBlock を使用す る ための要件 InsertBlock パ ラ メ ー タ を 使用す る
ためには、 以下の要件をすべて満たす必要があ り ま す。
•
デー タ パ イ プ ラ イ ン の中で、 ODBC ド ラ イ バを使用 し て転送先
デー タ ベース にア ク セ ス し てい る こ と
•
転送先デー タ ベー ス がバ イ ン ド 変数の使用を サポー ト し て い る こ
と （バ イ ン ド 変数については、 DisableBind を参照 し て く だ さ い）
•
転送先データ ベース のデータ ベース プロ フ ァ イ ルの中で、DisableBind
パ ラ メ ー タ が 1 （デフ ォ ル ト は 0） に設定 さ れていない こ と （ こ れ
に よ っ て、 PowerBuilder の中で、 コ ンパ イ ル済み SQL 文の入力パ
ラ メ ー タ のデフ ォ ル ト バ イ ン ド が許可 さ れ ま す）
•
デー タ パ イ プ ラ イ ン の中で、 ［最大エ ラ ー件数］ が 1 に設定 さ れて
いる こ と
Adaptive Server Anywhere ODBC ド ラ イ バ と 、 PB DataDirect ODBC ド ラ
イ バの大半は、 最初の 2 つの要件を満た し てい ま す。
使用 し てい る ODBC ド ラ イ バが、 こ れ ら の要件を満た し てい る か ど う
かについては、 ド ラ イ バ付属のマニ ュ アルを参照 し て く だ さ い。
InsertBlock 値の決定 PowerBuilder
InsertBlock 値を決定 し ま す。
は、 以 下 の 順 序 で 検 索 を し て、
1
使用 し てい る デー タ ベース プ ロ フ ァ イ ルに対応す る 、PowerBuilder
初期設定フ ァ イ ルの中のセ ク シ ョ ン
2
使用 し てい る ODBC ド ラ イ バに対応す る 、PBODB90 初期設定フ ァ
イ ルの中のセ ク シ ョ ン
こ れ ら の場所で InsertBlock 値が見つか ら ない場合、挿入ブ ロ ッ ク フ ァ
ク タ と し てデフ ォ ル ト 値の 100 行が適用 さ れ ま す。
設定後の処理 InsertBlock 値が決定 さ れ る と デー タ パ イ プ ラ イ ン は、
指定 さ れた行数をひ と ま と めに し て、 転送先デー タ ベース が使用 し て
い る ODBC ド ラ イ バへの 1 回の呼び出 し で こ れ を挿入 し ま す。
InsertBlock 値やデー タ パ イ プ ラ イ ン の コ ミ ッ ト フ ァ ク タ に 100 行 よ り
小 さ な値を指定 し た場合は、 指定行数をひ と ま と ま り と し て、 転送先
デー タ ベー ス に挿入 し ま す。 こ れに対 し て、 100 行 よ り 大 き な値 を指
定 し た場合は、 一度に 100 行ま で をひ と ま と ま り と し て、 転送先デー
タ ベース に挿入 し ま す。
96
PowerBuilder
第1章
DBParm パ ラ メ ー タ
デー タ パ イ プ ラ イ ンが実際に使用す る 挿入ブ ロ ッ ク フ ァ ク タ は、転送
先デー タ ベー ス に挿入 さ れ る 各カ ラ ム のデー タ サ イ ズ に依存 し ま す。
こ れに加え て デー タ パ イ プ ラ イ ン は、 1 つの カ ラ ム に対応す る バ ッ
フ ァ 内のデー タ が、 64K を越え る こ と はあ り ま せん。
ブ ロ ッ ク 挿入の禁止 デー タ パ イ プ ラ イ ン の中で、ODBC デー タ ソ ー
ス に対す る ブ ロ ッ ク 挿入を禁止す る には、 転送先デー タ ベー ス のデー
タ ベー ス プ ロ フ ァ イ ルで、 以下のいずれかの操作を実行 し ま す。
例
•
InsertBlock パ ラ メ ー タ を 1 に設定 し ま す。
•
DisableBind パ ラ メ ー タ を 1 に設定 し ま す （ コ ンパ イ ル済み SQL 文
への入力パ ラ メ ー タ のデフ ォ ル ト バ イ ン ド を禁止 し ま す）。
•
デー タ パ イ プ ラ イ ンの中で、 ［最大エ ラ ー件数］ を 1 以外の値に設
定 し ま す。
デー タ パ イ プ ラ イ ン におけ る 挿入ブ ロ ッ ク フ ァ ク タ を 50 行に設定す
る には、 以下の操作を行い ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ ト ラ ン ザ ク シ ョ ン］ タ ブの ［Insert ブ ロ ッ ク 化係数］ ボ ッ
ク ス に 50 と 入力 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "InsertBlock = 50"
関連項目
DisableBind
IntegratedSecurity
機能
デー タ サーバがユーザ を 識別す る た めに使用す る 認証サー ビ ス の名
前を指定 し ま す。
こ の DBParm が指定 さ れ る と 、 ほかの OLE DB 認証 DBParm
（CacheAuthentication、 EncryptPassword、 MaskPassword、 PersistEncrypted、
およ び PersistSecurityInfo） は必要な く 、 指定 さ れていて も 無視 さ れ ま
す。
IntegratedSecurity を指定す る タ イ ミ ン グ
IntegratedSecurity DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー
ス に接続す る 前に指定 し ま す。
対象
接続 リ フ ァ レ ン ス
OLE DB
97
JavaVM
構文
IntegratedSecurity = 'value'
パラ メ ー タ
value
説明
認証サー ビ ス の名前 を 指定す る 文字列。 NULL の場合は、 デ
フ ォ ル ト の認証サービ ス が使用 さ れ ます。
デフ ォル ト 値
なし
例
Security Support Provider Interface （SSPI） for Windows NT な ど の 認 証
サービ ス を使用す る には、 以下の操作を行い ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［セキ ュ リ テ ィ ］ タ ブで、 ［統合セキ ュ リ テ ィ ］ ボ ッ ク ス に
認証サービ ス の名前を入力 し ま す。
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
デー タ ベース プ ロ フ ァ イル
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "IntegratedSecurity='SSPI'"
JavaVM
機能
JDBC デー タ ベース イ ン タ フ ェ ース で使用す る Java VM のバージ ョ ン
を指定 し ま す。
JavaVM を指定す る タ イ ミ ン グ
JavaVM DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー ス に接続
す る 前に指定 し ま す。
対象
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 と 同 じ
バージ ョ ン の も の を実行時に使用す る 必要があ り ま す。
98
PowerBuilder
第1章
例
DBParm パ ラ メ ー タ
JavaVM DBParm パ ラ メ ー タ を Sun JRE 1.3 に設定す る には、 以下の操
作 を行い ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［オプ シ ョ ン］ タ ブで、 ［Java VM］ ド ロ ッ プ ダ ウ ン リ ス ト
の 「Sun JRE 1.3」 を選択 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "JavaVM = 'Sun1.3'"
KanjiEsc
機能
PowerBuilder 3.0 J 以前のバージ ョ ン で、 Informix や SQL Server に対 し
て作成 さ れた埋め込み SQL 文で、 日本語名の識別子や修飾子 （カ ラ ム
名、 テーブル名、 オーナ名） を単一引用符で囲んで記述 し ていた も の
を有効に し ま す。
初期の PowerBuilder 3.0 日本語版 （3.0J） では、 埋め込み SQL 文で日本
語のデー タ ベース 名、 テーブル名、 カ ラ ム名を使用す る 際、 SQL Server
（SYB イ ン タ フ ェ ース ） と Informix （INF イ ン タ フ ェ ース ） を使用す る
場合に、 こ れ ら を単一引用符で囲み、 特殊文字 と し て扱 う 必要があ り
ま し た。
PowerBuilder のバージ ョ ン 3.0a 以降では、 PowerBuilder 内部で日本語
文字を含んだ識別子、 修飾子を認識す る よ う に改善 し てい る ので、 日
本語名称のテーブルやカ ラ ム を単一引用符で囲 ま ずに、 埋め込み SQL
文を実行で き ま す。 逆に、 以前の単一引用符を用いた埋め込み SQL 文
はその ま ま 実行す る と 構文エ ラ ー と な っ て し ま い ま す。 こ のエ ラ ーを
回避す る ために、 KanjiEsc DBParm パ ラ メ ー タ が用意 さ れ、 値に 1 を
設定す る と 、 以前の単一引用符を用いた埋め込み SQL 文を実行す る こ
と がで き る よ う にな っ てい ま す。
注意
Informix や SQL Server に対す る 、単一引用符を用いた埋め込み SQL 文
は、 早い機会に単一引用符を削除 し た構文に変更 し て く だ さ い。
なお、 デー タ ウ ィ ン ド ウ の定義におけ る SQL SELECT 文は原則 と し て
修正す る 必要はあ り ま せん。
構文
接続 リ フ ァ レ ン ス
KanjiEsc=valueKanjiEsc=0
99
Language
例
以下の ス テー ト メ ン ト に よ っ て、Informix、Microsoft / Sybase SQL Server
に対す る 埋め込み SQL において、 単一引用符で囲ま れた識別子 と 修飾
子に対す る 構文処理が行われ ま す。
KanjiEsc = 1
Language
機能
Language を サポ ー ト す る イ ン タ フ ェ ー ス の場合、 タ ーゲ ッ ト デー タ
ベース への接続時に使用す る 言語を指定 し ま す。
Language を指定する タ イ ミ ン グ
Language DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー ス に接
続す る 前に指定 し ま す。 Language パ ラ メ ー タ の設定は、 デー タ ベー ス
に接続 し た時点で有効にな り ま す。
対象
MSS Microsoft SQL Server
SYC Sybase Adaptive Server Enterprise
構文
Language = 'language_name'
デフ ォル ト 値
なし
解説
Microsoft SQL Server Language DBParm パ ラ メ ー タ で、 エ ラ ー メ ッ
セージや日付書式を表示す る と き に使用す る 言語を指定 し ま す。
Language DBParm パ ラ メ ー タ の設定が、 PowerBuilder の中で効果 を発
揮す る ためには、 開発者 ま たはデー タ ベー ス 管理者が、 指定 さ れた言
語をデー タ ベー ス サーバ上にあ ら か じ め設定 し てお き ま す。 詳細につ
いては、 Microsoft SQL Server のマニ ュ アル を参照 し て く だ さ い。
Adaptive Server Enterprise Language パ ラ メ ー タ に 値 を 指 定す る と 、
PowerBuilder は以下の処理を行い ま す。
•
こ の接続に対 し て CS_LOCALE 構造体を割 り 当て ま す。
•
CS_SYB_LANG の値を、 指定 し た言語に設定 し ま す。
•
SQL Server CS_LOC_PROP 接続プ ロ パテ ィ に、 新 し い ロ ケール情
報を設定 し ま す。
Locale DBParm パ ラ メ ー タ は、 Open Client ソ フ ト ウ ェ ア が使用す る 言
語や文字セ ッ ト を指定 し ま す。 こ の Locale DBParm パ ラ メ ー タ がすで
に設定 さ れてい る 場合、 Language DBParm パ ラ メ ー タ に新 し い値を指
定 し 、 デー タ ベー ス と 再接続す る こ と に よ っ て、 言語の設定を変更 し
ま す。
100
PowerBuilder
第1章
DBParm パ ラ メ ー タ
Unicode デー タ ア ク セ ス PowerBuilder は、 Adaptive Server Enterprise
（ASE） 12.5 Unicode デー タ ベース 中、 ま たは ASE 12.5 の Unicode カ ラ
ム 中の Unicode デー タ に ア ク セ ス す る こ と がで き ま す。 PowerBuilder
は、 Language と CharSet パ ラ メ ー タ で設定 さ れてい る DBCS の値 （ま
たは、 Locale パ ラ メ ー タ で設定 さ れて い る DBCS の値） に従 っ て、 2
バ イ ト 文字 コ ー ド セ ッ ト （DBCS） デー タ と Unicode デー タ と を自動的
に変換 し ま す。
こ の例を以下に示 し ま す。
Language = 'japanese'
CharSet = 'sjis'
例
Language DBParm パ ラ メ ー タ を French に設定す る には、 以下の操作を
行い ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［接続］ タ ブ ま たは ［地域の設定］ タ ブで、 ［言語］ ボ ッ ク
ス に French と 入力 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "Language = 'French'"
関連項目
CharSet
Locale
LCID
機能
OLE DB デー タ プ ロ バ イ ダが使用す る ロ ケール識別子を指定 し ま す。
LCID を指定する タ イ ミ ン グ
LCID DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー ス に接続す
る 前に指定 し ま す。
対象
OLE DB
構文
LCID = 'lcid_nameí
デ フ ォル ト 値
なし
接続 リ フ ァ レ ン ス
101
Locale
解説
ロ ケール識別子は初期化時に指定 し ま す。 こ れに よ り 、 デー タ サーバ
が PowerBuilder の適切な ロ ケール言語お よ び文字セ ッ ト を判断で き る
よ う に な り ま す。 た だ し 、 こ の DBParm を 設定 し て も 、 PowerBuilder
に返 さ れ る すべての テ キ ス ト が ロ ケール ID に従 っ て変換 さ れ る と は
限 り ま せん。
例
ロ ケールを日本語に設定す る には、 以下の操作を行い ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［シ ス テ ム］ タ ブで、 ［ ロ ケール ID］ ボ ッ ク ス に次の よ う に
入力 し ま す。
デー タ ベース プ ロ フ ァ イル
1041
•
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "LCID = '1041'"
関連項目
CharSet
Language
Locale
機能
PowerBuilder か ら Sybase Adaptive Server Enterprise デー タ ベー ス を介 し
て ア ク セ ス す る デー タ ベース に接続す る と き に、 Sybase Open Client ソ
フ ト ウ ェ ア が使用す る ロ ケール名を指定 し ま す。
Locale を指定す る タ イ ミ ン グ
Locale DBParm パ ラ メ ー タ は、PowerBuilder か ら デー タ ベース に接続す
る 前に指定 し ま す。
対象
SYC Sybase Adaptive Server Enterprise
構文
Locale = 'locale_nameí
デフ ォル ト 値
LOCALES.DAT フ ァ イ ルに定義 さ れてい る デフ ォ ル ト の ロ ケール
解説
ロ ケール ロ ケールは、 LOCALES.DAT フ ァ イ ルのエ ン ト リ と し て格
納 さ れてい ま す。 LOCALES.DAT フ ァ イ ルには、 Sybase Open Client ソ
フ ト ウ ェ ア が使用す る 言語 と 文字セ ッ ト についての情報が定義 さ れて
い ま す。 Sybase Open Client ソ フ ト ウ ェ ア を イ ン ス ト ー ル す る と 、
¥SYBASE¥LOCALES デ ィ レ ク ト リ に LOCALES.DAT フ ァ イ ルが イ ン
ス ト ール さ れ ま す。
102
PowerBuilder
第1章
DBParm パ ラ メ ー タ
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 DBParm の必要性 Locale DBParm パ ラ メ ー タ に値 を 設定す る
と 、 Adaptive Server Enterprise デー タ ベース にア ク セ ス す る と き に、 デ
フ ォ ル ト ロ ケール以外の ロ ケールを使用で き ま す。 Locale の値が設定
さ れていない場合、 Sybase Open Client では LOCALES.DAT フ ァ イ ルに
定義 さ れてい る デフ ォ ル ト の ロ ケールが使用 さ れ ま す。
設定後の処理 Locale DBParm パラ メ ータ に値を 設定する と 、PowerBuilder
は以下の処理を し ま す。
•
こ の接続に対 し て CS_LOCALE 構造体を割 り 当て ま す。
•
CS_LC_ALL の値を、 指定 し た ロ ケール名に設定 し ま す。
•
SQL Server CS_LOC_PROP 接続プ ロ パテ ィ に、 新 し い ロ ケール情
報を設定 し ま す。
Locale DBParm の無効化 Locale DBParm パ ラ メ ー タ は、使用す る 言語
や文字セ ッ ト を指定 し ま す。 こ の Locale DBParm パ ラ メ ー タ がすでに
設定 さ れてい る 場合、Language ま たは CharSet DBParm パ ラ メ ー タ に新
し い値を指定 し 、 デー タ ベース と 再接続す る こ と に よ っ て、 言語や文
字セ ッ ト の設定を変更で き ま す。
Unicode デー タ ア ク セ ス PowerBuilder は、 ASE 12.5 Unicode デ ー タ
ベース 中、 ま たは ASE 12.5 の Unicode カ ラ ム中の Unicode デー タ にア
ク セ ス す る こ と がで き ま す。 Local パ ラ メ ー タ が DBCS の値で設定 さ れ
てい る 場合には、 PowerBuilder は、 ダブル バ イ ト 文字セ ッ ト （DBCS）
デー タ と Unicode 間で自動的に変換 し ま す。 た と えば、 Locale DBParm
は chs ま たは cht に設定 さ れな ければな り ま せん。
例
ロ ケール を fra に設定す る には、 以下の操作を行い ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［地域の設定］ タ ブで、 ［ ロ ケール］ ボ ッ ク ス に次の よ う に
入力 し ま す。
デー タ ベース プ ロ フ ァ イル
fra
•
接続 リ フ ァ レ ン ス
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
103
Location
SQLCA.dbParm = "Locale = 'fra'"
設定後の処理 Locale DBParm パ ラ メ ー タ を fra に設定 し た場合 と 、 以
下に示す よ う に Language パ ラ メ ー タ と CharSet DBParm パ ラ メ ー タ を
個別に設定 し た場合の結果は同 じ です。
Language = 'French'
CharSet = 'cp850'
関連項目
CharSet
Language
Location
機能
OLE DB デー タ プ ロ バ イ ダの接続先 と な る デー タ ソ ー ス の場所を指定
し ま す。 多 く の場合、 こ のデー タ ソ ー ス の場所はデー タ ベース サーバ
名 と な り ま す。
Location を指定する タ イ ミ ン グ
Location DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー ス に接続
す る 前に指定 し ま す。
対象
OLE DB
構文
Location = 'location_nameí
デフ ォル ト 値
なし
解説
Location パ ラ メ ー タ の実装は、 使用 し てい る OLE DB デー タ プ ロ バ イ
ダに よ っ て異な り ま す。 詳細は、 OLE DB ベン ダが提供す る デー タ プ
ロ バ イ ダのマニ ュ アルを参照 し て く だ さ い。
Log
機能
デー タ ベー ス サーバに、 テ キ ス ト デー タ や イ メ ージ デー タ の更新内
容 を ト ラ ン ザ ク シ ョ ン ロ グ に記録 さ せ る か ど う か を 指定 し ま す。 デ
フ ォ ル ト では、テ キ ス ト デー タ や イ メ ージ デー タ の更新内容がデー タ
ベース サーバに よ り ト ラ ンザ ク シ ョ ン ロ グ に記録 さ れ ま す。
対象
MSS Microsoft SQL Server
SYC お よ び SYJ Sybase Adaptive Server Enterprise
構文
Log = value
104
PowerBuilder
第1章
パラ メ ー タ
value
DBParm パ ラ メ ー タ
説明
デー タ ベー ス サーバに、 テ キ ス ト デー タ や イ メ ージ デー
タ の更新内容を ト ラ ン ザ ク シ ョ ン ロ グ に記録 さ せ る か ど う
か を指定す る 値。 以下のいずれかの値を指定 し ます。
• 0 テ キ ス ト や イ メ ージ の更新内容 を ト ラ ン ザ ク シ ョ ン
ロ グ に記録 し ま せん。 使用 し て い る デー タ ベー ス サー
バに、 ロ グ を取 ら ない機能が あ る 場合に限 っ て、 こ の値
を指定で き ます。
• 1 （デフ ォ ル ト ） テ キ ス ト や イ メ ージの更新内容を ト ラ
ンザ ク シ ョ ン ロ グに記録 し ます。
デ フ ォル ト 値
Log = 1
解説
使用 し てい る デー タ ベース サーバで、 ロ グ を取 ら ない機能があ る 場合
に限っ て、 Log パ ラ メ ー タ を 0 に設定で き ま す。
例
テ キ ス ト や イ メ ージ の更新内容を ト ラ ン ザ ク シ ョ ン ロ グ に記録 し な
い よ う に指定す る には、 以下の操作を行い ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［シ ス テ ム］ タ ブ ま たは ［ ト ラ ン ザ ク シ ョ ン］ タ ブの ［テ
キ ス ト と イ メ ージの更新 ロ グ を取得］ チ ェ ッ ク ボ ッ ク ス を オ フ に
し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "Log = 0"
LoginTimeOut
機能
JDBC デー タ ベー ス ま たは ODBC デー タ ソ ース への ロ グ イ ン リ ク エ ス
ト の最大待ち時間を、 秒単位で指定 し ま す。
対象
JDB JDBC
ODBC（ ド ラ イ バお よ びバ ッ ク エ ン ド DBMS がサポー ト し てい る 場合）
構文
LoginTimeOut = value
パラ メ ー タ
value
デ フ ォル ト 値
接続 リ フ ァ レ ン ス
説明
ド ラ イ バ の、 ロ グ イ ン リ ク エ ス ト に対す る最大待ち時間。
ODBC: LoginTimeOut = 15; JDBC: LoginTimeOut = 0
105
MaskPassword
解説
LoginTimeOut を 0 に設定 し た場合、PowerBuilder は LoginTimeOut 値を
設定す る ために JDBC ド ラ イ バ ま たは ODBC ド ラ イ バを呼び出 さ ず、
JDBC ド ラ イ バ ま たは ODBC ド ラ イ バの ク ラ イ ア ン ト ソ フ ト ウ ェ アが
指定 し た秒数の間待機 し ま す。 LoginTimeOut を 0 よ り 大 き い値に設定
す る と 、 PowerBuilder は JDBC ド ラ イ バ ま たは ODBC ド ラ イ バ を呼び
出 し て LoginTimeOut 値を設定 し ま す。
例
ログイン
リ ク エ ス ト の 最 大 待 ち 時間 が 60 秒 に な る よ う に、
LoginTimeOut パ ラ メ ー タ に値 を 設定す る には、 以下の操作 を 行い ま
す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ネ ッ ト ワ ー ク ］ タ ブで、 ［ タ イ ム ア ウ ト ］ ボ ッ ク ス に次の
よ う に入力 し ま す。
デー タ ベース プ ロ フ ァ イル
60
•
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "LoginTimeOut = 60"
MaskPassword
機能
OLE DB デー タ プ ロ バ イ ダへの接続時に、 パ ス ワ ー ド にマ ス ク を自動
的にかけ る よ う にす る か ど う か を指定 し ま す。
MaskPassword を指定す る タ イ ミ ン グ
MaskPassword DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー ス
に接続す る 前に指定 し ま す。
対象
OLE DB
構文
MaskPassword = 'value'
パラ メ ー タ
value
デフ ォル ト 値
106
説明
パ ス ワ ー ド にマ ス ク がかか る よ う にす る か ど う か を 指定す る
値。 以下のいずれかの値を指定 し ま す。
• True PowerBuilder がパ ス ワ ー ド にマ ス ク を かけ ます。
• False （デフ ォ ル ト ） PowerBuilder はパ ス ワー ド にマ ス ク を
かけ ません。
MaskPassword = 'False'
PowerBuilder
第1章
例
DBParm パ ラ メ ー タ
OLE DB デー タ プ ロ バ イ ダへの接続時にパ ス ワ ー ド にマ ス ク がかか る
よ う にす る には、 以下の操作を行い ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［セキ ュ リ テ ィ ］ タ ブで、 ［パ ス ワ ー ド のマ ス ク ］ チ ェ ッ ク
ボ ッ ク ス を オ ン に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "MaskPassword='True'"
関連項目
DataLink
EncryptPassword
IntegratedSecurity
PersistEncrypted
MaxConnect
機能
デー タ ベース にア ク セ ス す る と き の最大同時接続数を設定 し ま す。
同時接続のデフ ォ ル ト 数は 25 です。 デフ ォ ル ト 数は、 MaxConnect を
設定す る こ と で、 デー タ ベー ス サーバで設定 さ れた同時接続の最大数
ま で更新す る こ と がで き ま す。
MaxConnect を指定す る タ イ ミ ン グ
MaxConnect DBParm パ ラ メ ー タ の値は、 PowerBuilder のデー タ ベー ス
に接続す る 前に指定 し ま す。
対象
MSS Microsoft SQL Server
SYC Sybase Adaptive Server Enterprise
構文
MaxConnect = value
パラ メ ー タ
value
説明
デー タ ベー ス に ア ク セ ス す る ための同時接続の最大数
デ フ ォル ト 値
MaxConnect = 25
解説
SYC MaxConnect
は、 Sybase
CT-Lib
接続プ ロ パ テ ィ
CS_MAX_CONNECT を、 1 つの CT-Lib コ ン テ キ ス ト に対 し て指定 さ
れた同時接続デー タ ベース の数に設定 し ま す。
例
MaxConnect 値を最大値の 50 に設定す る には、以下の操作を行い ま す。
接続 リ フ ァ レ ン ス
107
MixedCase
•
（MSS イ ン タ フ ェー ス ま たは SYC イ ン
タ フ ェ ー ス を使用 し てい る 場合は） ［Client Library の最大接続数］
ボ ッ ク ス に 50 と 入力 し ま す。 こ のチ ェ ッ ク ボ ッ ク ス は、 SYC の場
合は ［ネ ッ ト ワ ー ク ］ タ ブに、 MSS の場合は ［ ト ラ ンザ ク シ ョ ン］
タ ブにあ り ま す。
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
デー タ ベース プ ロ フ ァ イル
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "MaxConnect = 50"
MixedCase
機能
Oracle デー タ ベー ス と の接続において、 大文字 と 小文字を区別す る か
ど う か を指定 し ま す。
デフ ォ ル ト では、 MixedCase パ ラ メ ー タ が 0 に設定 さ れ ま す。 デフ ォ
ル ト 設定では、 大文字 と 小文字を区別 し ない接続が指定 さ れ、 識別子
がすべて大文字 と し て扱われ ま す。 Oracle への接続時に大文字 と 小文
字が区別 さ れ る よ う にす る には、 MixedCase パ ラ メ ー タ に 1 を設定 し
ま す。
対象
O73 Oracle 7.3
O84 Oracle 8.x と Oracle8i
O90 Oracle9i
構文
MixedCase = value
パラ メ ー タ
value
説明
Oracle デー タ ベー ス と の接続で大文字 と 小文字を区別す る
か ど う か を指定す る 値。以下のいずれかの値を指定 し ます。
• 0 （デフ ォ ル ト ） Oracle デー タ ベー ス と の接続で、 大文
字 と 小文字 を区別 し ません。 すべての識別子が大文字 と
し て扱われます。
• 1 Oracle デー タ ベー ス と の接続で、大文字 と 小文字を区
別 し ます。 大文字、 小文字、 ま たは大文字 と 小文字が混
在 し た識別子がサポー ト さ れます。
デフ ォル ト 値
MixedCase = 0
解説
MixedCase パ ラ メ ー タ を 1 に設定 し た状態で、 Oracle デー タ ベー ス 上
のテーブルに対 し て主キーを定義す る 場合、 以下の英文識別子はすべ
て大文字に し ま す。
•
108
主キーの名前
PowerBuilder
第1章
例
•
主キー と テーブルの名前
•
主キーを参照す る すべての外部キーの名前
DBParm パ ラ メ ー タ
Oracle デー タ ベー ス と の接続で識別子の大文字 と 小文字を区別す る よ
う に指定す る には、 以下の操作を行い ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［接続］ タ ブで、 ［大文字小文字の区別］ チ ェ ッ ク ボ ッ ク ス
を オ ン に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "MixedCase = 1"
Mode
機能
OLE DB デー タ プ ロ バ イ ダへの ア ク セ ス パー ミ ッ シ ョ ン を 指定す る
値。
Mode を指定す る タ イ ミ ン グ
Mode DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー ス に接続す
る 前に指定 し ま す。
対象
OLE DB
構文
Mode = 'value'
パラ メ ー タ
value
デ フ ォル ト 値
接続 リ フ ァ レ ン ス
説明
OLE DB デー タ プ ロ バ イ ダへのア ク セ ス パー ミ ッ シ ョ ン を指
定す る 値。 以下のいずれかの値を指定 し ます。
• Deny read share ほ かの ユーザが読み込みモー ド で開 く の
を禁止 し ます。
• Deny write share ほ かのユーザが書 き 込みモー ド で開 く こ
と を禁止 し ます。
• Exclusive share ほかのユーザが読み込み / 書 き込みモー ド
で開 く こ と を禁止 し ます。
• No share deny ほ かのユーザは、 読み込みア ク セ ス も 書 き
込みア ク セ ス も 拒否 さ れません。
• Read/Write 読み込み / 書 き込みア ク セ ス を許可 し ます。
• Read-only 読み込みア ク セ ス を許可 し ます。
• Write-only 書 き 込みア ク セ ス を許可 し ま す。
なし
109
MsgTerse
例
OLE DB デー タ プ ロ バ イ ダへの読み込み / 書 き 込みア ク セ ス を ほかの
ユーザに許可す る には、 以下の操作を行い ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ ト ラ ンザ ク シ ョ ン］ タ ブで、 ［モー ド ］ リ ス ト ボ ッ ク ス の
「Read/Write」 を選択 し ま す。
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
デー タ ベース プ ロ フ ァ イル
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
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'
パラ メ ー タ
value
説明
SQLSTATE の表示 を省い たエ ラ ー メ ッ セー ジ を表示す る
か ど う か を 指定す る 値。 以下のいずれか の値 を 指定 し ま
す。
• Yes SQLSTATE の 表示 を 省い た エ ラ ー メ ッ セー ジ を
表示 し ます。
• No （デ フ ォ ル ト ） SQLSTATE を表示す る エ ラ ー メ ッ
セージ を表示 し ます。
デフ ォル ト 値
MsgTerse = 'No'
解説
MsgTerse DBParm パ ラ メ ー タ に 'Yes' を設定す る こ と に よ っ て、 簡略化
し た JDBC ま たは ODBC エ ラ ー メ ッ セージ を 表示で き ま す。 エ ラ ー
メ ッ セージ を表示す る ス ク リ ーン の大 き さ に制限が あ る 場合、 こ の設
定はたいへん効果的です。
110
PowerBuilder
第1章
DBParm パ ラ メ ー タ
た と えば、 PowerBuilder のデー タ パ イ プ ラ イ ン を使用 し て、 Adaptive
Server Anywhere ODBC デー タ ベース に対す る パ イ プ ラ イ ン処理をす る
と き に、 エ ラ ーが発生 し た も の と し ま す。 MsgTerse パ ラ メ ー タ が 'No'
（デフ ォ ル ト 値） に設定 さ れてい る と 、 以下に示す よ う に、 SQLSTATE
（SQLSTATE = 2300） と い う 表示を伴 う パ イ プ ラ イ ン エ ラ ーが、 デー
タ パ イ プ ラ イ ン ダ イ ア ロ グ ボ ッ ク ス に表示 さ れ ま す。
Adaptive Server Anywhere デー タ ベー ス のデー タ ベー ス プ ロ フ ァ イ ル
に MsgTerse ='Yes' を指定す る と 、 以下に示す よ う に、 デー タ パ イ プ ラ
イ ン におい て、 SQLSTATE の表示を省いた ODBC エ ラ ー メ ッ セージ
が表示 さ れ ま す。
デー タ パ イ プ ラ イ ンの使い方については、『ユーザーズ ガ イ ド 』 マニ ュ
アルを参照 し て く だ さ い。
例
SQLSTATE 表示が省かれ た エ ラ ー メ ッ セージ が表示 さ れ る よ う に指
定す る には、 以下の操作を行い ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［シ ス テ ム］ タ ブで、［簡易エ ラ ー メ ッ セージの表示］ チ ェ ッ
ク ボ ッ ク ス を オ ンに し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "MsgTerse = 'Yes'"
NumbersInternal
機能
デー タ ベース か ら 数値を取得す る 際に OCI 文字列のかわ り に Oracle の
内部 21 バ イ ト バ イ ナ リ NUMBER デー タ 型書式が使用 さ れ る よ う に
指定 し ま す。 EBCDIC 文字セ ッ ト ま たは、 ほかの非 ASCII 文字セ ッ ト
を使っ て設定 さ れてい る Oracle デー タ ベース にア ク セ スす る 場合にの
み、 NumbersInternal DBParm を使 う のが適切です。
NumbersInternal を指定す る タ イ ミ ン グ
NumbersInternal DBParm パ ラ メ ー タ は、PowerBuilder か ら デー タ ベー ス
に接続す る 前に指定 し ま す。
対象
O84 Oracle 8.x お よ び Oracle8 i
O90 Oracle9i
構文
NumbersInternal = value
接続 リ フ ァ レ ン ス
111
NumericFormat
パラ メ ー タ
value
説明
数 値 を 取 得 す る 際 に Oracle の 内 部 21 バ イ ト バ イ ナ リ
NUMBER デー タ 型書式が使用 さ れ る よ う に指定 し ま す。以
下のいずれかの値を指定 し ます。
• 0 （デフ ォ ル ト ） 内部書式の数値を取得 し ません。
• 1 内部書式の数値を取得 し ます。
デフ ォル ト 値
NumbersInternal = 0
解説
NumbersInternal DBParm を使 う と 、 デー タ ベー ス か ら 数値を取得す る
際に Oracle の内部 21 バ イ ト バ イ ナ リ NUMBER デー タ 型書式が使用
さ れ る よ う に指定で き る ほか、 結果を解読す る ための内部アルゴ リ ズ
ム も 提供 さ れ ま す。
例
数値取得の際に Oracle の内部書式が使用 さ れ る よ う に指定す る には、
以下の操作を行い ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［構文］ タ ブで、 ［内部書式での数値の検索］ チ ェ ッ ク ボ ッ
ク ス をオ ン に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "NumbersInternal = 1"
NumericFormat
機能
DBMS ま たはバ ッ ク エ ン ド デー タ ベー ス でサポー ト さ れてい る 場合、
NumericFormat を設定す る と 、 SQL 構文の数値文字列を特別に書式化
す る よ う に ド ラ イ バに指示が出 さ れ ま す。 こ の書式は、 デー タ ウ ィ ン
ド ウ オ ブ ジ ェ ク ト お よ び レ ポ ー ト 内に内部的に作成 さ れデー タ ベー
ス に送信 さ れ る SQL 構文の数値の生成方法に影響 し ま す。
対象
JDB JDBC
ODBC
構文
構文は、 ア ク セ ス し てい る バ ッ ク エ ン ド DBMS、 数値文字列の書式化
の し かたに よ っ て異な り ま す。
Oracle デー タ ベー ス に対す る 典型的な構文の例を以下に示 し ま す。 こ
こ では、 小数点記号 と し て カ ン マ を使用 し て、 数値文字列を書式化 し
て い ま す （PowerBuilder で作成 さ れ、 デー タ ベー ス に送信 さ れ る SQL
構文の数値書式の生成方法については、 以下の 「例」 を参照 し て く だ
さ い）。
112
PowerBuilder
第1章
DBParm パ ラ メ ー タ
PowerBuilder 開発環境では、 DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク
ス に、 必要な場所に特殊文字 （引用符） が挿入 さ れ る ので、 指定す る
のは NumericFormat 値 （ こ の例の %s） だけでか ま い ま せん。
PowerBuilder ア プ リ ケーシ ョ ン ス ク リ プ ト では、 以下の構文を使用す
る 必要があ り ま す。
ODBC イ ン タ フ ェ ース を経由 し て IBM DB2 デー タ ベー
ス にア ク セ ス し てい る 場合、 以下の NumericFormat 構文を使用 し ま す。
文字列の前後に 1 つの単一引用符が使用 さ れてい る 点に注意 し て く だ
さ い。
IBM DB2 構文
NumericFormat = '%s,%s'
JDBC ま たは ODBC イ ン タ フ ェ ー ス
を 経由 し て Oracle デー タ ベ ー ス に ア ク セ ス し て い る 場合、 以下 の
NumericFormat 構文を使用 し ま す。文字列の前後に 3 つの単一引用符が
使用 さ れてい る 点に注意 し て く だ さ い。
ORACLE JDBC ま たは ODBC 構文
NumericFormat = '''%s,%s'''
パラ メ ー タ
説明
'
IBM DB2 構文
"'
%s
,
小数点記号 （ こ の場合はカ ン マ） を表 し ます。
%s
数値文字列の中の、 小数点の右側の数値を表 し ます。 こ の
値は、 PowerBuilder が SQL 構文を作成す る と き に、 小数点
の右側の数値に置 き 換え ら れま す。
IBM DB2 構文 終了の単一引用符 を 1 つ入力 し ま す。 終了
の単一引用符は、 PowerBuilder で作成 さ れデー タ ベー ス に
送信 さ れ る SQL 構文の中には返 さ れ ま せん が、 IBM DB2
デー タ ベース では必要 と さ れま す。
ORACLE JDBC ま たは ODBC 構文 終了の単一引用符を 3 つ
入力 し ま す。 1 番目 と 2 番目の引用符は、 PowerBuilder で作
成 さ れデー タ ベー ス に送信 さ れ る SQL 構文の中で、 1 つの
終了の単一引用符 と し て解析 さ れま す。
'
'''
デ フ ォル ト 値
接続 リ フ ァ レ ン ス
開始の単一引用符 を 1 つ入力 し ま す。 開始
の単一引用符は、 PowerBuilder で作成 さ れデー タ ベー ス に
送信 さ れ る SQL 構文 の 中 に は返 さ れ ま せ ん が IBM DB2
デー タ ベース では必要 と さ れま す。
ORACLE JDBC ま たは ODBC 構文 開始の単一引用符を 3 つ
入力 し ま す。 2 番目 と 3 番目の引用符は、 PowerBuilder で作
成 さ れ、 デー タ ベー ス に送信 さ れ る SQL 構文の中で、 1 つ
の開始の単一引用符 と し て解析 さ れ ます。
数値文字列の中の、 小数点の左側の数値を表 し ます。 こ の
値は、 PowerBuilder が SQL 構文を作成す る と き に、 小数点
の左側の数値に置 き 換え ら れま す。
なし
113
NumericFormat
解説
NumericFormat パ ラ メ ー タ を設定す る 必要性 一般に、 NumericFormat
DBParm パ ラ メ ー タ を設定す る 必要は あ り ま せん。 大部分のバ ッ ク エ
ン ド 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
•
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "NumericFormat = '%s,%s'"
操作の結果 PowerBuilder は、 デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト お よ び
レ ポー ト の中に次の SQL INSERT 文を内部的に作成 し て、 デー タ ベー
ス に送信 し ま す。 こ の SQL 構文の中には、単一引用符が返 さ れ ま せん。
INSERT INTO MYTABLE (a, b)
VALUES (125,50, 4,0)
次の例では、 '125,50' と '4,0' と
い う 書式の 2 つの数値が作成 さ れ る よ う に指定す る 方法を 示 し ま す。
PowerBuilder に よ っ てデー タ ウ ィ ン ド ウ オブジ ェ ク ト お よ びレ ポー ト
の中に作成 さ れ Oracle デー タ ベース に送信 さ れ る SQL 構文の中では、
カ ン マが小数点記号 と し て使用 さ れ ま す。
例 2 （Oracle JDBC ま たは ODBC 構文）
•
114
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［構文］ タ ブで、 ［Numeric 型の書式］ ボ ッ ク ス に次の よ う
に入力 し ま す。
デー タ ベース プ ロ フ ァ イル
PowerBuilder
第1章
DBParm パ ラ メ ー タ
%s,%s
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
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 Oracle 8.x お よ び Oracle8i
O90 Oracle9i
構文
ObjectMode = value
パラ メ ー タ
value
説明
オ ブ ジ ェ ク ト モー ド を 有効にす る か し な い か を 指定 し ま
す。 以下のいずれかの値を指定 し ます。
• Yes （デフ ォ ル ト ） オブジ ェ ク ト モー ド を使用 し ます。
• No オブ ジ ェ ク ト モー ド を使用 し ません。
デ フ ォル ト 値
Yes
解説
オブジ ェ ク ト モー ド を無効にす る ためには、 DB プ ロ フ ァ イ ル設定 ダ
イ ア ロ グ ボ ッ ク ス の ［接続］ タ ブ で、 ［オブ ジ ェ ク ト モー ド ］ ボ ッ ク
ス のチ ェ ッ ク を外すか、 ス ク リ プ ト 中で ObjectMode に "No" を設定 し
ま す。
接続 リ フ ァ レ ン ス
115
OJSyntax
例
オブ ジ ェ ク ト モー ド を無効にす る 場合の指定方法 :
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［接続］ タ ブで ［オブ ジ ェ ク ト モー ド ］ チ ェ ッ ク ボ ッ ク ス
のチ ェ ッ ク を外 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.DBParm = "ObjectMode ='No'"
OJSyntax
機能
ア ク セ ス 先デー タ ベー ス バ ッ ク エ ン ド で外部結合 SQL 構文を フ ォ ー
マ ッ ト す る 方法を指定 し ま す。
対象
IN9 Informix
JDB JDBC
MSS
ODBC
OLE DB
構文
OJSyntax = value
パラ メ ー タ
value
説明
SQL 構文の フ ォ ーマ ッ ト 方法を 指定 し ま す。 以下のいずれ
かの値を指定 し ま す。
• ANSI_Escape ANSI 規格を適用 し 、 外部結合 をエ ス ケー
プ表記 { oj ... } で囲み ます。 こ れに よ り 、 外部結合は ド ラ
イ バに よ っ て解析 さ れた後、 DBMS 固有の文法で置 き 換
え ら れま す。
• ANSI ANSI 規格を適用 し ます。
• PB PowerBuilder 9 に適用 さ れてい る 規則を遵守 し ます。
デフ ォル ト 値
OJSyntax = ANSI （IN9 お よ び MSS の場合）、 OJSyntax = ANSI_ESCAPE
（JDBC、 ODBC、 お よ び OLE DB の場合）
解説
Oracle 以外 の PowerBuilder デー タ ベー ス イ ン タ フ ェ ー ス は すべ て、
ANSI SQL-92 外 部 結 合 SQL 構 文 の 生 成 を サ ポ ー ト し て い ま す。
PowerBuilder は、 グ ラ フ ィ ッ ク ス モー ド では左外部結合 と 右外部結合
の両方 を サ ポ ー ト し 、 構文モ ー ド で は完全外部結合 と 内部結合 を サ
ポー ト し てい ま す。
116
PowerBuilder
第1章
DBParm パ ラ メ ー タ
IN9、 MSS、 ODBC、 OLE DB、 お よ び JDBC の場合、 PowerBuilder に生
成 さ せ る 外部結合 SQL 構文のバージ ョ ン を 明示す る には、 OJSyntax
DBParm を設定す る 必要があ り ま す。 ODBC、 OLE DB、 お よ び JDBC
の場合、 デフ ォ ル ト では ANSI_Escape が適用 さ れ ま すが、 ANSI ま た
は PB （ネ イ テ ィ ブ） に リ セ ッ ト す る こ と も 可能です。 IN9 と MSS の場
合、 デフ ォ ル ト では ANSI が適用 さ れ ま すが、 PB に リ セ ッ ト す る こ と
も 可能です。
OJSyntax は、OJSyntax を サポー ト す る デー タ ベー ス ド ラ イ バすべての
中にあ る 動的 DBParm です。 つま り 、 次の よ う な PowerScript 文を使用
し たデー タ ベース 接続を し てい る 間は、 いつで も OJSyntax を変更で き
ま す。
SQLCA.DBParm="OJSyntax='ANSI_ESCAPE' "
移植性の確保のためには、 SQL ペ イ ン タ で外部結合を定義す る SQL
ペ イ ン タ で外部結合 SELECT 文を グ ラ フ ィ カルに定義 し た場合、 デー
タ ウ ィ ン ド ウ オブジ ェ ク ト は SQL を擬似 コ ー ド と し て格納 し ま す。 実
行時には、 現在の OJSyntax DBParm 設定に基づいて、 外部結合構文が
生成 さ れ ま す。 こ れに よ っ て、 複数の DMBS 内のデー タ ウ ィ ン ド ウ オ
ブ ジ ェ ク ト について、 あ る 程度の移植性を提供す る こ と が可能にな り
ま す。
外部結合 SELECT 文を構文モー ド で定義 し た場合、 デー タ ウ ィ ン ド ウ
オブジ ェ ク ト は SQL を構文 と し て格納 し ます。 実行時は、 こ の構文が
変更な し で使用 さ れ ま す。 OJSyntax DBParm の設定は、 SQL には影響
し ま せん。
ネ イ テ ィ ブ外部結合構文の使い方 ネ イ テ ィ ブ外部結合構文は、 オプ
シ ョ ン PB を指定 し た場合に生成 さ れ ま す。
Sybase¥Shared¥PowerBuilder¥pbodb90.ini フ ァ イ ルの中の DBMS に対応
し た SYNTAX セ ク シ ョ ン に PBOuterJoin 構文エ ン ト リ と
PBOuterJoinOperator 構文エ ン ト リ が設定 さ れてい る 場合にのみ、 オプ
シ ョ ン PB を ODBC と OLE DB で使用で き ま す。
HKEY_CURRENT_USER¥Software¥Sybase¥PowerBuilder¥9.0¥pbjdbc
キ ー の 中 の DBMS に 対 応 し た キ ー の Windows レ ジ ス ト リ に
PBOuterJoin 構文エ ン ト リ と PBOuterJoinOperator 構文エ ン ト リ が設定
さ れてい る 場合にのみ、 PB オプ シ ョ ン を JDBC で使用で き ま す。 こ の
キ ー は、 デ フ ォ ル ト で は イ ン ス ト ー ル さ れ ま せ ん。 使用 し て い る
DBMS に合わせて PowerBuilder JDBC 設定の追加や変更を行え る レ ジ
ス ト リ フ ァ イ ルのサン プルについては、Sybase¥Shared¥PowerBuilder 内
の egreg.txt フ ァ イ ルを参照 し て く だ さ い。
接続 リ フ ァ レ ン ス
117
OptSelectBlob
PowerBuilder 7 お よ び こ れ よ り 前のバージ ョ ン の PowerBuilder か ら ア
プ リ ケーシ ョ ン を移行す る 場合、ANSI 外部結合の構文を使用 し てい る
と 、 ペ イ ン タ での結合定義の方法に よ っ ては、 エ ラ ーが発生す る こ と
が あ り ま す。 1 つのテーブルが右外部結合に よ り 複数の テーブルに結
合 さ れてい る 場合、 有効な ANSI 外部結合文を生成す る こ と はで き ま
せん。
外部結合についての詳細は、 『ユーザーズ ガ イ ド 』 マニ ュ アルの ANSI
外部結合の使い方に関す る セ ク シ ョ ン を参照 し て く だ さ い。
OJSyntax は SYC には適用 さ れない SYC の デ ー タ ベー ス イ ン タ
フ ェ ース では、デー タ ベース サーバが ANSI を サポー ト し てい る 場合、
以下の表に示す よ う にデー タ ベー ス 接続はデフ ォ ル ト で ANSI 外部結
合 SQL 構文 と な り ま す。
イ ン タ フ ェ ース
SYC
例
外部結合のサポー ト
接続先 Adaptive Server デー タ ベー ス サーバのバー ジ ョ
ン を確認 し ま す。 Adaptive Server 12 以降に接続 し てい る
場合、SYC は自動的に ANSI 外部結合 SQL 構文 を使用 し
ます。
OJSyntax の値を設定す る には、 以下の操作を行い ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［構文］ タ ブの ［Outer Join 構文］ ド ロ ッ プダ ウ ン リ ス ト か
ら 適切な値を選択 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "OJSyntax = 'ANSI'"
OptSelectBlob
機能
SELECTBLOB SQL 文を発行 し て、 デー タ ウ ィ ン ド ウ オブジ ェ ク ト の
一部で あ る テーブル行の Blob カ ラ ム を選択す る と 、 SELECTBLOB リ
ク エ ス ト を処理す る と き に出 る 結果保留 （Results Pending） エ ラ ーを避
け る ために、 PowerBuilder はデフ ォ ル ト で 2 番目のデー タ ベー ス 接続
を開 き ま す。
こ のパ ラ メ ー タ を設定す る 必要があ る のは、 Blob が含 ま れてい る デー
タ ウ ィ ン ド ウ を接続に使用 し ない場合だけです。
118
PowerBuilder
第1章
DBParm パ ラ メ ー タ
処理を最適化す る には、 OptSelectBlob DBParm パ ラ メ ー タ を 1 に設定
し ま す。 こ の設定が PowerBuilder に リ ク エ ス ト を処理す る ための初期
デー タ ベース 接続を指示 し ま す。 2 番目の接続では、 結果保留 （Results
Pending） エ ラ ーを回避す る 必要はあ り ま せん。
OptSelectBlob を指定する タ イ ミ ン グ
OptSelectBlob DBParm パ ラ メ ー タ は、 PowerBuilder のデー タ ベー ス に
接続す る と き や、 接続がオープ ン にな っ てい る 間に指定で き ま す。
対象
MSS Microsoft SQL Server
構文
OptSelectBlob = value
パラ メ ー タ
value
説明
MSS Microsoft SQL Server デー タ ベース イ ン タ フ ェ ー ス を使
用す る デー タ ウ ィ ン ド ウ オブジ ェ ク ト で、 処理を最適化す
る か ど う か を指定 し ま す。 以下のいずれか の値 を 指定 し ま
す。
• 0 （デ フ ォ ル ト ） 処理 を 最適化 し ま せ ん。 こ の 設定は、
SELECTBLOB リ ク エ ス ト を 処 理 す る た め の 2 番 目 の
デー タ ベー ス接続を オープ ンす る よ う に PowerBuilder に
指示 し ま す。 こ の設定は、 デー タ ウ ィ ン ド ウ オブ ジ ェ ク
ト で読み込むための Blob ま たはバ イ ナ リ デー タ を選択
す る場合に使用 し ます。
• 1 処理を最適化 し ます。こ の処理は、2 番目の接続を オー
プ ン にす る かわ り に、 リ ク エ ス ト を 処理す る 初期のデー
タ ベー ス接続 を使用す る よ う に PowerBuilder に指示 し ま
す。 こ の設定は、 デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト で読み
込むための Blob ま たはバ イ ナ リ デー タ を選択 し ない場
合に使用 し ます。
デ フ ォル ト 値
0
解説
設定が必要な場合 デー タ ウ ィ ン ド ウ オ ブ ジ ェ ク ト で 読み込むた め
の Blob ま たはバ イ ナ リ デー タ を選択 し ない場合は、 OptSelectBlob を
1 に設定 し て処理を最適化 し ま す。
OptSelectBlob を 1 に設定す る と 、 PowerBuilder は初期接続を使用 し て
リ ク エ ス ト を処理す る ため、 検証は行われ ま せん。 つま り 、 使用す る
デー タ ウ ィ ン ド ウ オブジ ェ ク ト が Blob ま たはバ イ ナ リ デー タ を読み
込ま ない こ と を確認 し た う えで、 OptSelectBlob を 1 に設定す る よ う 注
意 し て く だ さ い。 以上の作業が行われない と 、 デー タ の読み込み時に
結果保留 （Result Pending） エ ラ ーを引 き 起 こ し ま す。
接続 リ フ ァ レ ン ス
119
OraMTSConFlgs
例
MSS Microsoft SQL Server イ ン タ フ ェ ー ス を 使用 し て いてデー タ ウ ィ
ン ド ウ オブジ ェ ク ト 内の Blob ま たはバ イ ナ リ デー タ を読み込ま ない
場合に処理を最適化す る には、 以下の操作を行い ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［構文］ タ ブの ［SelectBlob 処理の最適化］ チ ェ ッ ク ボ ッ ク
ス を オ ン に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "OptSelectBlob = 1"
OraMTSConFlgs
機能
MTS に配布 さ れた ト ラ ン ザ ク シ ョ ン 用 PowerBuilder コ ン ポーネ ン ト
の 動作 を 指定 し ま す。 こ の DBParm パ ラ メ ー タ が 適用 さ れ る の は、
PowerBuilder カ ス タ ム ク ラ ス ユーザ オブ ジ ェ ク ト を MTS コ ン ポーネ
ン ト と し て配布 し 、 こ のオブジ ェ ク ト を Oracle 8.1.5 以降のデー タ ベー
ス に接続 し てい る 場合だけです。
対象
O84 Oracle 8.x お よ び Oracle8i （8.1.5 以降のデー タ ベース 接続のみ）
O90 Oracle9i
構文
OraMTSConFlgs = 'value'
120
PowerBuilder
第1章
パラ メ ー タ
value
DBParm パ ラ メ ー タ
説明
MTS に配布 さ れた ト ラ ン ザ ク シ ョ ン用 コ ン ポーネ ン ト の
動作 を指定 し ます。 以下のいずれかの値 を指定 し ます。
• All Default （デフ ォ ル ト ） プール さ れた接続を取得 し 、
MTS ト ラ ン ザ ク シ ョ ン 内 に あ る 接 続 を 登録 し ま す。
（ORAMTS_CFLG_ALLDEFAULT）
• No Implicit Enlistment プール さ れた接続 を 取得 し ま す
が、 コ ン ポーネ ン ト が ト ラ ン ザ ク シ ョ ン用で も MTS ト
ラ ン ザ ク シ ョ ン 内 に あ る リ ソ ー ス は 登 録 し ま せ ん。
（ORAMTS_CFLG_NOIMPLICIT）
• Unique Server Session OCI Server ご と に 1 つ の OCI
セ ッ シ ョ ン を要求 し ます。 Version 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'
解説
MTS に配布 さ れ た ト ラ ン ザ ク シ ョ ン 用 PowerBuilder コ ン ポーネ ン ト
が O84 か O90 デー タ ベー ス イ ン タ フ ェ ース を使用 し て Oracle 8.1.5 以
降のデー タ ベース に接続す る 場合、 MTS はプール さ れた接続を取得 し
て その接続を ト ラ ン ザ ク シ ョ ン内に登録 し よ う と し ま す。 別の動作を
指定す る こ と も 可能です。 その場合は、 使用可能なオプ シ ョ ン を 1 つ
ま たは複数選択 し ま す。
Oracle O84 か O90 デー タ ベー ス イ ン タ フ ェ ース が MTS で実行 さ れて
い る と き は、デフ ォ ル ト で ThreadSafe モー ド が有効にな り 、ThreadSafe
DBParm の値は無視 さ れ ます。
こ のパ ラ メ ー タ は、 動的に設定す る こ と がで き ま せん。 接続の確立時
に設定 さ れた値は、 接続が切断す る ま で有効です。
こ れ ら の値は、 同時には指定で き ま せん。 連鎖 さ せ る 場合は、 DBParm
の中でパ イ プ文字を使用 し ま す。
MTS ト ラ ンザ ク シ ョ ン をサポー ト する ための条件
Oracle Services for Microsoft Transaction Server の イ ン ス ト ール と 設定が
必要です。
接続 リ フ ァ レ ン ス
121
PackageProcs
例
INTERNAL ア カ ウ ン ト を使用 し て、 登録済みの接続を 取得す る には、
以下の操作を行い ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［EAServer/MTS］ タ ブ で、 ［予備の INTERNAL ロ グ イ ン］
チ ェ ッ ク ボ ッ ク ス をオ ン に し ま す。 ［すべてデフ ォ ル ト ］ チ ェ ッ ク
ボ ッ ク ス は、 デフ ォ ル ト でオ ン にな り ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ア プ リ
ケーシ ョ ン ス ク リ プ ト で以下の入力を行い ま す （フ ラ グ の論理和
を指定す る ために｜を使用 し ま す）。
SQLCA.dbParm = "OraMTSConFlgs =
'ORAMTS_CFLG_ALLDEFAULT|ORAMTS_CFLG_PRELIMAUTH'"
PackageProcs
機能
Oracle デー タ ベー ス パ ッ ケージの中にカプセル化 さ れてい る ス ト ア ド
プ ロ シージ ャ と 関数が、 デー タ ウ ィ ン ド ウ お よ びデー タ ベース ペ イ ン
タ に表示 さ れ る Oracle ス タ ン ド ア ロ ン ス ト ア ド プ ロ シージ ャ お よ び
関数の リ ス ト に追加 さ れ る よ う に指定 し ま す。
PackageProcs を指定する タ イ ミ ン グ
PackageProcs DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベース に
接続す る 前に指定 し ま す。
対象
O73 Oracle 7.3
O84 Oracle 8.x と Oracle8i
O90 Oracle9i
構文
PackageProcs = value
パラ メ ー タ
value
デフ ォル ト 値
122
説明
パ ッ ケージ ス ト ア ド プ ロ シージ ャ と 関数を、 ス ト ア ド プ
ロ シージ ャ お よ び関数の リ ス ト に追加す る よ う に指定 し ま
す。 以下のいずれかの値 を指定 し ます。
• 0 （デ フ ォ ル ト ） パ ッ ケージ ス ト ア ド プ ロ シージ ャ と
関数を追加 し ません。
• 1 パ ッ ケージ ス ト ア ド プ ロ シージ ャ と 関数 を追加 し ま
す。
PackageProcs = 0
PowerBuilder
第1章
DBParm パ ラ メ ー タ
解説
パ ッ ケージ と は、 Oracle デー タ ベー ス 内に一緒に格納 さ れてい る 関連
プ ロ グ ラ ム オブジ ェ ク ト （プ ロ シージ ャ 、 関数、 変数、 お よ びカー ソ
ルな ど ） の コ レ ク シ ョ ン を カ プセル化 し た も のです。 パ ッ ケージの中
に含 ま れてい る オブ ジ ェ ク ト を一覧表示す る と 、 Oracle デー タ ベー ス
接続にパ フ ォ ーマ ン ス 上のペナルテ ィ が課 さ れ る 可能性があ り ま す。
こ れ ら の オ ブ ジ ェ ク ト を デー タ ウ ィ ン ド ウ ペ イ ン タ で表示す る と 、
REF CURSOR 文 ま たは SELECT 文のパ ラ メ ー タ が含 ま れ てい る オ ブ
ジ ェ ク ト のみが一覧表示 さ れ ま す。 デー タ ベース ペ イ ン タ で表示す る
と 、 オブ ジ ェ ク ト 全部が一覧表示 さ れ ま す。 表示 さ れ る テ キ ス ト ソ ー
ス は、 パ ッ ケージ全体のテ キ ス ト ソ ー ス です。
例
Oracle パ ッ ケージ オブ ジ ェ ク ト が ス ト ア ド プ ロ シージ ャ お よ び関数
の リ ス ト に追加 さ れ る よ う に指定す る には、 以下の操作を行い ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［シ ス テ ム］ タ ブで、 ［パ ッ ケージ サブプ ロ グ ラ ム を リ ス ト
す る ］ チ ェ ッ ク ボ ッ ク ス を オ ンに し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "PackageProcs = 1"
PacketSize （ODBC）
機能
PowerBuilder の ODBC デー タ ソ ー ス に ア ク セ ス す る と き は、 ネ ッ ト
ワ ー ク パケ ッ ト サ イ ズ をバ イ ト 単位で指定 し ま す。
バ ッ ク エ ン ド DBMS の多 く は、 PacketSize オプ シ ョ ン をサポー ト し な
いか、 現行のネ ッ ト ワ ー ク パケ ッ ト サ イ ズ を返すだけです。 ア ク セ ス
し て い る DBMS が PacketSize を サ ポ ー ト す る か ど う か につ い て は、
DBMS のマニ ュ アルを参照 し て く だ さ い。
PacketSize を指定す る タ イ ミ ン グ
バ ッ ク エ ン ド DBMS が PacketSize を サ ポ ー ト す る 場合、 PacketSize
DBParm パ ラ メ ー タ は、PowerBuilder か ら デー タ ベー ス に接続す る 前に
指定 し ま す。
対象
ODBC（ODBC 2.0 以上の ド ラ イ バお よ びバ ッ ク エ ン ド DBMS がサポー
ト し てい る 場合）
構文
PacketSize = value
接続 リ フ ァ レ ン ス
123
PacketSize
パラ メ ー タ
value
説明
バ イ ト 単位のネ ッ ト ワ ー ク パケ ッ ト サ イ ズ を表す 32 ビ ッ ト
の整数
デフ ォル ト 値
PacketSize パ ラ メ ー タ のデ フ ォ ル ト 値は、 バ ッ ク エ ン ド DBMS のデ
フ ォ ル ト 値です。
解説
指定 し た PacketSize の値が、 最大ネ ッ ト ワ ー ク パケ ッ ト サ イ ズ よ り 大
き い場合、 ま たは最小ネ ッ ト ワー ク パケ ッ ト サ イ ズ よ り 小 さ い場合、
最大値ま たは最小値が、 指定 し た値に置 き 換え ら れ ま す。
例
ODBC デー タ ソ ース に対す る ネ ッ ト ワ ー ク パケ ッ ト サ イ ズ を、 2048
バ イ ト に設定す る には、 以下の操作を行い ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ネ ッ ト ワー ク ］ タ ブで、 ［パケ ッ ト サ イ ズ］ ボ ッ ク ス に次
の よ う に入力 し ま す。
デー タ ベース プ ロ フ ァ イル
2048
•
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "PacketSize = 2048"
PacketSize
機能
SQL Server デー タ ベー ス と 接続す る と き に、 PowerBuilder ア プ リ ケー
シ ョ ン と デー タ ベース サーバ間での、 デー タ 転送のパケ ッ ト のサ イ ズ
を バ イ ト 単位で指定 し ま す。 パケ ッ ト と は、 ネ ッ ト ワ ー ク を介 し て情
報を送 る 際の固定長のデー タ のかた ま り です。
サーバは、 実際のパケ ッ ト サ イ ズ を、 PacketSize パ ラ メ ー タ で指定 し
た値、 ま たはそれ よ り 小 さ い値に設定 し ま す。 サーバの容量に制限が
あ る 場合、 サーバはパケ ッ ト サ イ ズ を指定 さ れた値 よ り も 小 さ く 設定
し ま すが、 それ以外の場合は PacketSize パ ラ メ ー タ の値に設定 し ま す。
デフ ォ ル ト 値は 512 バ イ ト です。
PacketSize を指定する タ イ ミ ン グ
PacketSize DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベース に接
続す る 前に指定 し ま す。
対象
124
MSS Microsoft SQL Server
SYC Sybase Adaptive Server Enterprise
PowerBuilder
第1章
構文
DBParm パ ラ メ ー タ
PacketSize = value
パラ メ ー タ
value
説明
デー タ ベー ス サーバ と ア プ リ ケ ーシ ョ ン と の間のデー タ 転
送におけ る Byte 単位のパ ケ ッ ト サ イ ズ。 512 の倍数を指定 し
ます。 デ フ ォ ル ト 値は 512 バ イ ト です。
デ フ ォル ト 値
PacketSize = 512
解説
設定が必要な場合 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
•
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "PacketSize = 2048"
接続 リ フ ァ レ ン ス
125
PBCatalogOwner
PBCatalogOwner
機能
拡張属性シ ス テ ム テーブルにデ フ ォ ル ト 以外のオーナ を指定 し ま す。
それ ら 5 種類のテーブルは、 デー タ ベース のデフ ォ ル ト 拡張属性情報
を格納 し てい ま す。
PBCatalogOwner パ ラ メ ー タ に、 DBMS におけ る デフ ォ ル ト のオーナ以
外の名前を指定す る と 、 そ のオーナ名で、 テーブルのセ ッ ト が新 し く
作成 さ れ ま す。
PBCatalogOwner を指定する タ イ ミ ン グ
PBCatalogOwner DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー
ス に接続す る 前に指定 し ま す。
対象
JDB JDBC
MSS Microsoft SQL Server
ODBC
OLE DB
O73 Oracle 7.3
O84 Oracle 8.x と Oracle8i
O90 Oracle9i
SYC お よ び SYJ Sybase Adaptive Server Enterprise
構文
PBCatalogOwner = 'owner_name'
パラ メ ー タ
owner_name
デフ ォル ト 値
説明
拡張属性シ ス テ ム テーブルのオーナ
DB2 デー タ ベース の場合 DB2SYSPB.SQL ス ク リ プ ト を使
用 し て、 DB2 デー タ ベー ス内に拡張属性シ ス テ ム テーブ
ル を作成 し 、 ス ク リ プ ト 内の PBOwner イ ン ス タ ン ス をす
べてデフ ォ ル ト 以外の テーブル オーナ名で置 き換え る 場
合、owner_name を DB2SYSPB.SQL ス ク リ プ ト に指定 さ れ
てい る オーナ と 同 じ 名前に し な ければな り ません。
PBCatalogOwner パ ラ メ ー タ のデ フ ォ ル ト 値は、 次の表に示す よ う に、
ア ク セ ス し てい る DBMS に よ っ て異な り ま す。
DBMS
PBCatalogOwner パ ラ メ ー タ のデ フ ォ ル ト 値
JDBC
PBCatalogOwner の値がデー タ ベー ス プ ロ フ ァ イ ル
ま たは レ ジ ス ト リ で指定 さ れていない場合、 デー タ
ベー ス プ ロ フ ァ イ ル に 指定 さ れ て い る ユ ーザ ID
が、 デフ ォ ル ト 値 と し て使用 さ れ ます。
Microsoft SQL Server
126
PBCatalogOwner = 'dbo'
PowerBuilder
第1章
DBMS
PBCatalogOwner パ ラ メ ー タ のデ フ ォ ル ト 値
ODBC
PBCatalogOwner パ ラ メ ー タ の値が、 デー タ ベー ス
プ ロ フ ァ イ ルに も PBODBn0 初期設定フ ァ イ ルに も
指定 さ れてい ない場合、デー タ ベー ス プ ロ フ ァ イ ル
に指定 さ れてい る ユーザ ID が、 デ フ ォ ル ト 値 と し
て使用 さ れ ます。
OLE DB
PBCatalogOwner の値がデー タ ベー ス プ ロ フ ァ イ ル
ま たは レ ジ ス ト リ で指定 さ れていない場合、 デー タ
ベー ス プ ロ フ ァ イ ル に 指定 さ れ て い る ユ ーザ ID
が、 デフ ォ ル ト 値 と し て使用 さ れ ます。
Oracle
Sybase Adaptive Server
Enterprise
解説
DBParm パ ラ メ ー タ
PBCatalogOwner = 'SYSTEM'
PBCatalogOwner = 'dbo'
設定が必要な場合 拡張属性シ ス テ ム テーブルのオーナに、 デフ ォ ル
ト 以外のオーナ を指定す る こ と に よ っ て、 新たに別のテーブル を作成
す る こ と がで き ま す。 こ の機能は、 デフ ォ ル ト テーブル内の現行の拡
張属性を変更す る こ と な く 、 新 し い入力条件則や表示書式を テ ス ト す
る と き に便利です。
JDBC デー タ ベース JDBC デー タ ベース に接続す る と き 、
PBCatalogOwner の値がデー タ ベース プ ロ フ ァ イ ル と レ ジ ス ト リ の両
方で設定 さ れてい る 場合、 プ ロ フ ァ イ ルの設定が レ ジ ス ト リ の設定に
優先 し ま す。
ODBC デー タ ソ ー ス ODBC デー タ ソ ー ス に接続す る と き 、
PBCatalogOwner の値が、 デー タ ベー ス プ ロ フ ァ イ ル と PBODB90 初期
設定フ ァ イ ルの両方に設定 さ れてい る 場合、 プ ロ フ ァ イ ル内の設定
が、 PBODB90 初期設定フ ァ イ ルの設定に優先 し ま す。
DB2 デー タ ベース DB2 デー タ ベー ス に接続す る 際には、
DB2SYSPB.SQL ス ク リ プ ト を使用 し て拡張属性シ ス テ ム テーブル を
作成で き ま す。 DB2SYSPB.SQL ス ク リ プ ト を使用す る 場合は、 以下の
こ と を念頭に置かな ければな り ま せん。
•
ス ク リ プ ト を編集 し て PBOwner の イ ン ス タ ン ス をすべて別の名前
に変更す る こ と も 可能ですが、 か わ り に ス ク リ プ ト 内のテーブル
オーナ を PBOwner の ま ま に し てお く （デフ ォ ル ト ） こ と も 可能で
す。
SYSIBM を指定で き ない場合
SYSIBM を テーブルのオーナの名前 と し て指定す る こ と はで き ま
せん。 こ の指定は DB2 に よ っ て禁止 さ れ ま す。
接続 リ フ ァ レ ン ス
127
PBMaxBlobSize
•
PBCatalogOwner パ ラ メ ー タ は、 こ の ス ク リ プ ト に指定 さ れてい る
オーナに設定で き ま すが、 ス ク リ プ ト が編集 さ れていない場合は
PBOwner に設定で き ま す。
こ のパ ラ メ ー タ は、 動的設定にで き ま せん。 接続の確立時に設定 さ れ
た値は、 接続が切断す る ま で有効です。
例
以下の例は、 TEST と い う オーナで、 新 し い拡張属性シ ス テ ム テーブ
ル を 作 成 し ま す。 新 し い テ ー ブ ル の 名 前 に は、 TEST.pbcatcol や
TEST.pbcatedt な ど の よ う に、 TEST と い う 修飾子が付け ら れ ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［シ ス テ ム］ タ ブで、 ［PowerBuilder カ タ ロ グ テーブル オー
ナ］ ボ ッ ク ス に次の よ う に入力 し ま す。
デー タ ベース プ ロ フ ァ イル
TEST
•
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "PBCatalogOwner = 'TEST'"
PBMaxBlobSize
機能
PowerBuilder が メ モ リ に読み込む こ と がで き る 最大の Blob サ イ ズ を指
定 し ま す。
PBMaxBlobSize を指定する タ イ ミ ン グ
PBMaxBlobSize DBParm パ ラ メ ー タ の値は、 PowerBuilder か ら デー タ
ベース に接続す る 前に指定 し ま す。
対象
OLE DB
構文
PBMaxBlobSize = value
デフ ォル ト 値
PBMaxBlobSize = 32767
128
PowerBuilder
第1章
DBParm パ ラ メ ー タ
解説
PowerBuilder は Blob の最大サ イ ズ を制限 し ま せん。Blob の最大サ イ ズ
は、ア プ リ ケーシ ョ ンが動作 し てい る マシ ン に よ っ て決ま り ま す。Blob
サ イ ズが、 ア プ リ ケーシ ョ ン が動作 し てい る マ シ ン の利用可能な メ モ
リ 容量 を 超 え る 場合、 PowerBuilder は OLE DB デー タ プ ロ バ イ ダ が
ISequentialStream イ ン タ フ ェ ー ス を サポー ト し ていれば Blob を ま と ま
り で読み込み ま す。 Blob サ イ ズがデフ ォ ル ト 値を超え、 OLE DB デー
タ プ ロ バ イ ダが ISequentialStream イ ン タ フ ェ ー ス を サポー ト し ていな
い場合、 PowerBuilder は Blob の端を切 り 捨て て、 メ モ リ 不足エ ラ ーを
報告 し ま す。 PBMaxBlobSize DBParm は、 Blob の最大サ イ ズ を大 き く
す る ために使用 し ま す。
例
PBMaxBlobSize 値を 200000 に設定す る には、 以下の操作を行い ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ ト ラ ンザ ク シ ョ ン］ タ ブで、 ［ メ モ リ 上の BLOB の最大サ
イ ズ］ ボ ッ ク ス に次の よ う に入力 し ま す。
デー タ ベース プ ロ フ ァ イル
200000
•
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "PBMaxBlobSize = 200000"
PBUseProcOwner
機能
ODBC イ ン タ フ ェ ース を経由 し てデー タ ベー ス にア ク セ ス し 、 デー タ
ソ ー ス と し て ス ト ア ド プ ロ シージ ャ を使用す る デー タ ウ ィ ン ド ウ オ
ブ ジ ェ ク ト を定義す る 場合に、 ド ラ イ バに渡 さ れ る SQL EXECUTE 文
の中のオーナ名 を 使 っ て ス ト ア ド プ ロ シージ ャ を 修飾す る か ど う か
を指定 し ま す。
ス ト ア ド プ ロ シージ ャ のオーナが、 現行のユーザ （デー タ ウ ィ ン ド ウ
オ ブ ジ ェ ク ト を 作成 し て い る 開発者、 ま た はデー タ ウ ィ ン ド ウ オ ブ
ジ ェ ク ト があ る アプ リ ケーシ ョ ン を稼働 し てい る エ ン ド ユーザ） の ID
と 異な る 場合に限っ て、 ス ト ア ド プ ロ シージ ャ がオーナ名で修飾 さ れ
ま す。
対象
ODBC
構文
PBUseProcOwner = 'value'
接続 リ フ ァ レ ン ス
129
PBUseProcOwner
パラ メ ー タ
value
説明
デー タ ウ ィ ン ド ウ オブジ ェ ク ト で作成 さ れ、 ド ラ イ バに
渡 さ れ る SQL EXECUTE 文の中で、 ス ト ア ド プ ロ シー
ジ ャ をオーナ名で修飾す る か ど う か を指定す る値。 以下
のいずれかの値を指定 し ます。
• Yes ス ト ア ド プ ロ シージ ャ のオーナが現行のユーザ
ID と 異 な る 場合、 SQL EXECUTE 文の中で ス ト ア ド
プ ロ シージ ャ がオーナ名で修飾 さ れ、 その情報が ド ラ
イ バ に渡 さ れ ま す。 こ れに よ っ て ユーザは、 自分が
オーナで ない ス ト ア ド プ ロ シージ ャ も 実行で き ます。
こ の例を以下に示 し ます。
EXECUTE FRAN.MYPROCEDURE
• No （デ フ ォ ル ト ） ド ラ イ バに渡 さ れ る デー タ ウ ィ ン
ド ウ の SQL EXECUTE 文の中で、 ス ト ア ド プ ロ シー
ジ ャ がオーナ名で修飾 さ れません。 こ の例 を以下に示
し ます。
EXECUTE MYPROCEDURE
デフ ォル ト 値
PBUseProcOwner = 'No'
解説
PBUseProcOwner 値の判定 PowerBuilder は、 以下の順序で検索を実行
し 、 PBUseProcOwner 値を判定 し ま す。
1
使用 し てい る デー タ ベース プ ロ フ ァ イ ルに対応す る PowerBuilder
初期設定フ ァ イ ルの中のセ ク シ ョ ン （開発環境の場合）、 ま たはト
ラ ン ザク ショ ン オブジェ ク ト DBParm プロ パティ の値（PowerBuilder
ア プ リ ケーシ ョ ン の場合）
2
使用 し てい る ODBC ド ラ イ バに対応す る 、PBODB90 初期設定フ ァ
イ ルの中のセ ク シ ョ ン
こ れ ら の場所で PBUseProcOwner 値が見つか ら ない場合、 デフ ォ ル ト
値の 'No' が適用 さ れ ま す。
DBA が Adaptive Server Anywhere ス ト ア ド プ ロ シージ ャ を所有す る 場
合 DBA （デー タ ベース 管理者） は、 Adaptive Server Anywhere 構文の
予約語です。
デー タ ソ ー ス と し て Adaptive Server Anywhere ス ト ア ド プ ロ シージ ャ
を使用す る デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト を定義 し た と き に、DBA が
ス ト ア ド プ ロ シージ ャ のオーナの場合、 PBUseProcOwner 値が Yes に
設定 さ れてい る と 、以下の SQL EXECUTE 文が ODBC ド ラ イ バに渡 さ
れ ま す。
EXECUTE DBA.MYPROCEDURE
130
PowerBuilder
第1章
DBParm パ ラ メ ー タ
こ の ス テー ト メ ン ト は、 DBA と い う 予約語があ る ために、 構文エ ラ ー
を発生 し ま す。
DBA がオーナで あ る Adaptive Server Anywhere ス ト ア ド プ ロ シージ ャ
を使用す る 場合、 PBUseProcOwner 値を No に設定す る と 、 ス ト ア ド プ
ロ シージ ャ が DBA で修飾 さ れないため、 構文エ ラ ーを回避で き ま す。
し か し 、 場合に よ っ ては、 ス ト ア ド プ ロ シージ ャ を DBA オーナで修
飾す る 必要があ り ま す。 DBA が別のユーザ ID に実行のパー ミ ッ シ ョ
ン を許可す る 場合な ど が こ れに相当 し ま す。 こ の場合、 デー タ ウ ィ ン
ド ウ で作成 さ れた SQL EXECUTE 文を編集 し 、DBA を引用符で囲む こ
と に よ っ てエ ラ ーを回避で き ま す。
EXECUTE "DBA".MYPROCEDURE
例
SQL EXECUTE 文の中で、 ス ト ア ド プ ロ シージ ャ がそのオーナ名で修
飾 さ れ る よ う に指定す る には、 以下の操作を行い ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ ト ラ ン ザ ク シ ョ ン］ タ ブ で、 ［ ス ト ア ド プ ロ シージ ャ に
オーナ名を修飾］ チ ェ ッ ク ボ ッ ク ス を オ ン に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm="PBUseProcOwner='Yes'"
PersistEncrypted
機能
OLE DB イ ン タ フ ェ ー ス を介 し て ア ク セ ス し て い る デー タ ソ ー ス が、
暗号化 さ れたパ ス ワ ー ド を保存で き る か ど う か指定 し ま す。
PersistEncrypted を指定する タ イ ミ ン グ
PersistEncrypted DBParm パ ラ メ ー タ は、PowerBuilder か ら デー タ ベー ス
に接続す る 前に指定 し ま す。
対象
OLE DB
構文
PersistEncrypted = 'value'
接続 リ フ ァ レ ン ス
131
PersistSensitive
パラ メ ー タ
value
説明
デー タ ソ ー ス が暗号化 さ れたパ ス ワ ー ド を保存で き る か ど う
か を指定す る 値。 以下のいずれかの値を指定 し ま す。
• True デー タ ソ ー スはパ ス ワ ー ド を保存で き ます。
• False （デ フ ォ ル ト ） デー タ ソ ー ス はパ ス ワ ー ド を保存で
き ま せん。
デフ ォル ト 値
PersistEncrypted = 'False'
例
OLE DB を介 し て ア ク セ ス し てい る デー タ ソ ー ス がパ ス ワー ド を保存
で き る よ う にす る には、 以下の操作を行い ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［セ キ ュ リ テ ィ ］ タ ブで、［暗号化パ ス ワー ド の保持］ チ ェ ッ
ク ボ ッ ク ス をオ ン に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm="PersistEncrypted='True'"
関連項目
DataLink
MaskPassword
EncryptPassword
PersistSensitive
PersistSensitive
機能
OLE DB イ ン タ フ ェ ー ス を介 し て ア ク セ ス し て い る デー タ ソ ー ス が、
パ ス ワー ド な ど の認証情報を保存で き る か ど う か を指定 し ま す。
PersistSensitive を指定す る タ イ ミ ン グ
PersistSensitive DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー ス
に接続す る 前に指定 し ま す。
対象
OLE DB
構文
PersistSensitive = 'value'
132
PowerBuilder
第1章
パラ メ ー タ
value
DBParm パ ラ メ ー タ
説明
デー タ ソ ー ス が認証情報 を 保存で き る か ど う か を 指定す る
値。 以下のいずれかの値 を指定 し ます。
• True デー タ ソ ー ス が認証情報を保存で き ま す。
• False （デ フ ォ ル ト ） デー タ ソ ー ス は認証情報 を 保存で き
ません。
デ フ ォル ト 値
PersistSensitive = 'False'
例
OLE DB を介 し て ア ク セ ス し てい る デー タ ソ ー ス が認証情報を保存で
き る よ う にす る には、 以下の操作を行い ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［セ キ ュ リ テ ィ ］ タ ブで、［セキ ュ リ テ ィ 情報の保持］ チ ェ ッ
ク ボ ッ ク ス を オ ンに し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm="PersistSensitive='True'"
関連項目
MaskPassword
EncryptPassword
PersistEncrypted
Properties
機能
デー タ ベー ス に接続す る ために使用 し てい る 特定の JDBC ド ラ イ バに
固有のプ ロ パテ ィ を設定 し ま す。
対象
JDB JDBC
構文
Properties = 'property_value'
デ フ ォル ト 値
なし
解説
［ ド ラ イ バ固有のプ ロ パテ ィ ］ ボ ッ ク ス では、 特定の ド ラ イ バに固有の
プ ロ パテ ィ を設定で き ま す。
JDBC ド ラ イ バがサポー ト す る プ ロ パテ ィ については、ベン ダのマニ ュ
アルを参照 し て く だ さ い。
ユーザ ID と パスワー ド の定義
プ ロ パテ ィ が定義 さ れてい る 場合は、 プ ロ パテ ィ ボ ッ ク ス でユーザ ID
と パ ス ワ ー ド も 定義す る 必要があ り ま す。
接続 リ フ ァ レ ン ス
133
ProtectionLevel
例
Sybase jConnect ド ラ イ バのプ ロ パテ ィ を設定す る には、 以下の操作を
行い ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［接続］ タ ブで、 ［ ド ラ イ バ固有のプ ロ パテ ィ ］ ボ ッ ク ス に
次の よ う に入力 し ま す。
デー タ ベース プ ロ フ ァ イル
SQLINITSTRING=set TextSize 32000;
user=sa;password=manager
•
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "Properties = 'SQLINITSTRING=set
TextSize 32000;user=sa;password=manager'"
関連項目
Driver
URL
ProtectionLevel
機能
OLE DB デー タ プ ロ バ イ ダ を介 し て PowerBuilder と デー タ サーバの間
で 送信 さ れ る デー タ に 適 用す る 保護 の レ ベル を 指定 し ま す。 こ の
DBParm は、 Remote Procedure Call （RPC） 接続以外のネ ッ ト ワ ー ク 接
続だけに適用 さ れ ま す。 認証 さ れた RPC 接続で も 、 同 じ よ う な レベル
の保護を指定で き ま す。
ProtectionLevel を指定する タ イ ミ ン グ
ProtectionLevel DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー ス
に接続す る 前に指定 し ま す。
対象
OLE DB
構文
ProtectionLevel = 'value'
134
PowerBuilder
第1章
パラ メ ー タ
value
DBParm パ ラ メ ー タ
説明
PowerBuilder と デー タ サーバの間で送信 さ れ る デー タ に適用
す る保護の レベル を指定す る 値。以下のいずれかの値を指定 し
ます。
• Not set ど の レベルの保護 も 選択 さ れま せん。
• Call ク ラ イ ア ン ト か ら サーバへの各 リ ク エ ス ト の最初に
デー タ の ソ ー ス を認証 し ます。
• Connect ク ラ イ ア ン ト が サーバ と の接続 を 確立 し た と き
にだけ認証 を行い ます。
• な し デー タ の認証は実行 さ れません。
• Packet 受信 し たすべてのデー タ が ク ラ イ ア ン ト か ら の も
ので あ る こ と を認証 し ます。
• Packet （Integrity） 受信 し たすべ て のデー タ が ク ラ イ ア ン
ト か ら の も の で あ り 、 途中でデー タ が変更 さ れてい ない こ
と を認証 し ます。
• Packet （Privacy） 受信 し たすべてのデー タ が ク ラ イ ア ン ト
か ら の も の で あ り 、 そのデー タ が途中で変更 さ れてい ない
こ と を認証 し 、 デー タ を暗号化 し てデー タ のプ ラ イ バシ を
保護 し ます。
デ フ ォル ト 値
Not set
例
PowerBuilder と デー タ サーバの間で送信 さ れ る デー タ の保護の レベル
を設定す る には、 以下の操作を行い ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［セ キ ュ リ テ ィ ］ タ ブで、 ［保護 レベル］ ド ロ ッ プダ ウ ン リ
ス ト の 「Connect」 を選択 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm=
"PROTECTIONLEVEL='DB_PROT_LEVEL_CONNECT"
関連項目
DataLink
Provider
機能
接続 リ フ ァ レ ン ス
デー タ ソ ー ス に接続す る ために使用す る デー タ プ ロ バ イ ダ を 識別 し
ま す。
135
Provider
Provider を指定する タ イ ミ ン グ
Provider DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー ス に接続
す る 前に指定 し ま す。
対象
OLE DB
構文
Provider = 'provider_name'
デフ ォル ト 値
なし
解説
［プ ロ バ イ ダ］ ド ロ ッ プ ダ ウ ン リ ス ト に表示 さ れ る 、 イ ン ス ト ール済
みデー タ プ ロ バ イ ダの リ ス ト か ら デー タ プ ロ バ イ ダ を選択 し ま す。 た
と えば、 Microsoft OLE DB Provider for ODBC を使用 し てい る 場合は、
Provider 値 と し て MSDASQL を選択 し ま す。 Microsoft OLE DB Provider
for SQL Server を使用 し てい る 場合は、 Provider 値 と し て SQLOLEDB
を選択 し ま す。
詳細については、 OLE DB デー タ プ ロ バ イ ダが提供す る マニ ュ アルを
参照 し て く だ さ い。
例
Microsoft OLE DB Provider for ODBC を使用 し て EAS Demo DB に
接続す る には以下の よ う に し ま す。
例1
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［接続］ タ ブで、 ［プ ロ バ イ ダ］ ド ロ ッ プ ダ ウ ン リ ス ト の
「MSDASQL」 を選択 し ま す。
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
デー タ ベース プ ロ フ ァ イル
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "Provider = 'MSDASQL'"
PB DataDirect OLE DB Provider を使用 し て Oracle 8 デー タ ベー ス
に接続す る には以下の よ う に し ま す。
例2
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［接続］ タ ブで、 ［プ ロ バ イ ダ］ ド ロ ッ プ ダ ウ ン リ ス ト の
「PB Oracle 8 OLE DB Provider」 を選択 し ま す。
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
デー タ ベース プ ロ フ ァ イル
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "Provider = 'PB Oracle8 OLE DB
Provider'"
Microsoft OLE DB Provider for Oracle を使用 し て Oracle 8 デー タ
ベース に接続す る には以下の よ う に し ま す。
例3
136
PowerBuilder
第1章
DBParm パ ラ メ ー タ
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［接続］ タ ブ で、 ［プ ロ バ イ ダ］ ド ロ ッ プ ダ ウ ン リ ス ト の
「MSDAORA」 を選択 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "Provider = 'MSDAORA'"
関連項目
DataLink
DataSource
ProviderString
機能
Microsoft SQL Server デー タ ベー ス に接続す る と き に、 接続先のサーバ
上の特定のデー タ ベース を識別 し ま す。
ProviderString を指定する タ イ ミ ン グ
ProviderString DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー ス
に接続す る 前に指定 し ま す。
対象
OLE DB （Microsoft SQL Server 接続のみに適用）
構文
ProviderString = 'value'
デ フ ォル ト 値
なし
解説
Microsoft SQL Server は 1 つのサーバでデー タ ベース の複数の イ ン ス タ
ン ス を サポー ト す る ので、 デー タ ベー ス 名を入力す る こ と で接続先の
特定のデー タ ベース を識別す る 必要があ り ま す。
詳細については、 Microsoft SQL Server のマニ ュ アルを参照 し て く だ さ
い。
例
特定の Microsoft SQL Server デー タ ベース を識別す る には、以下の操作
を行い ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［接続］ タ ブで、 ［拡張プ ロ パテ ィ ］ ボ ッ ク ス に次の よ う に
入力 し ま す。
デー タ ベース プ ロ フ ァ イル
Database = demodb1
•
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "ProviderString = 'database=demodb1'"
接続 リ フ ァ レ ン ス
137
ProxyUserName
関連項目
URL
ProxyUserName
機能
EAServer がプ ロ キ シ を介 し て接続キ ャ ッ シ ュ か ら 接続を取得す る よ う
に指定 し ま す。
こ の DBParm パ ラ メ ー タ は、PowerBuilder カ ス タ ム ク ラ ス ユーザ オブ
ジ ェ ク ト が EAServer コ ン ポーネ ン ト と し て配布 さ れ る 場合だけ使用
し ま す。
対象
JDB JDBC
ODBC
SYJ Sybase Adaptive Server Enterprise
構文
ProxyUserName = 'value'
パラ メ ー タ
value
説明
接続の使用が可能な代替 ロ グ イ ン名を指定 し ま す。
デフ ォル ト 値
なし
解説
キ ャ ッ シ ュ へのア ク セ ス の際にユーザか名前の ど ち ら を使用す る かに
かかわ ら ず、 プ ロ キ シ を介 し て接続を取得で き ま す。 プ ロ キ シ を介 し
て接続を取得 し た場合、 代替 ロ グ イ ン名を入力す る こ と に よ っ て、 別
のユーザの ID と 権限を使用で き ま す。
こ の機能は、 SQL コ マ ン ド set session authorization を認識す る デー タ
ベース で利用で き ま す。 ユーザ A が ProxyUserName DBParm を使用 し
て別のユーザ B の ID を使用で き る よ う にす る には、 こ の ス テー ト メ
ン ト の実行パー ミ ッ シ ョ ン を ユーザ A に付与 し てお く 必要が あ り ま
す。 た と えば、 Adaptive Server Anywhere の場合は、 DBA 権限を ユーザ
A に付与 し てお く 必要があ り 、 Adaptive Server Enterprise の場合は、 set
session authorization を 実行す る パー ミ ッ シ ョ ン を ユーザ A に付与 し
てお く 必要があ り ま す。
138
PowerBuilder
第1章
DBParm パ ラ メ ー タ
SYJ イ ン タ フ ェ ースの使用
Sybase EAServer は、 わずかに異な る バージ ョ ン の CT-Lib ソ フ ト ウ ェ
ア を使用 し ま す。 し たが っ て、実行時に、Adaptive Server Enterprise デー
タ ベ ー ス に 接 続す る に は SYC で は な く SYJ デー タ ベ ー ス イ ン タ
フ ェー ス を使用す る 必要があ り ま す。 SYJ の DB プ ロ フ ァ イ ル設定 ダ
イ ア ロ グ ボ ッ ク ス を使用す る と 、 適切な接続パ ラ メ ー タ が設定 さ れ、
構文を ［プ レ ビ ュ ー］ タ ブか ら ト ラ ンザ ク シ ョ ン オブ ジ ェ ク ト の ス ク
リ プ ト に コ ピーで き ま す。
ただ し 、 PowerBuilder 開発環境か ら デー タ ベー ス に接続す る 場合には
SYJ イ ン タ フ ェ ー ス を 使用で き ま せん。 し たが っ て、 開発段階で （ コ
ン ポーネ ン ト が EAServer に配布 さ れ る 前に）、 SYC を使用 し てデー タ
ベース に接続す る 必要があ り ま す。
PowerBuilder を使用 し て EAServer コ ン ポーネ ン ト を作成 し 、 プ ロ キ シ
設定の有効化を サポー ト す る 方法につい ては、 『ア プ リ ケーシ ョ ン テ
ク ニ ッ ク 』 マニ ュ アル を参照 し て く だ さ い。
例
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク ス の ［EAServer］ タ ブで、 ［プ
ロ キ シ ユーザ名］ ボ ッ ク ス に代替 ロ グ イ ン名を入力 し ま す。
ProxyUserName DBParm パ ラ メ ー タ の PowerScript 構文が、 次の よ う に
［プ レ ビ ュ ー］ タ ブに表示 さ れ ま す。
SQLCA.dbParm = "ProxyUserName = 'pikachu'"
こ の構文を ［プ レ ビ ュ ー］ タ ブか ら ス ク リ プ ト に コ ピー し ま す。
関連項目
CacheName
PWDialog
機能
実行時にユーザのパ ス ワ ー ド の有効期限が切れた場合、 PowerBuilder
ア プ リ ケ ーシ ョ ン でパ ス ワ ー ド が期限切れです ダ イ ア ロ グ ボ ッ ク ス
を表示す る か ど う か を制御 し ま す。
PWDialog が 1 に設定 さ れてい る 場合、有効期限が切れたパ ス ワー ド を
使っ てデー タ ベー ス に ロ グ イ ン し よ う と す る と 、 パ ス ワ ー ド が期限切
れです ダ イ ア ロ グボ ッ ク ス が表示 さ れ、 ユーザに対 し てパ ス ワー ド の
変更を求め ま す。 デフ ォ ル ト では、 PWDialog は 0 に設定 さ れ、 実行時
に ア プ リ ケーシ ョ ン でパ ス ワ ー ド が期限切れです ダ イ ア ロ グ ボ ッ ク
ス は表示 さ れ ま せん。
接続 リ フ ァ レ ン ス
139
PWDialog
PWDialog の設定値は、実行時にのみ PowerBuilder アプ リ ケーシ ョ ン に
影響 し ま す。 PowerBuilder 開発環境では、 PWDialog の設定値にかかわ
ら ず、 パ ス ワー ド の変更 ダ イ ア ロ グ ボ ッ ク ス が表示 さ れ、 ユーザに対
し て有効期限が切れたパ ス ワ ー ド の変更を求め る ので、 開発環境の場
合は無効です。
PWDialog を指定する タ イ ミ ン グ
PWDialog DBParm の値は、 PowerBuilder か ら デー タ ベース に接続す る
前に指定 し ま す。
対象
O73 Oracle 7.3
O84 Oracle 8.x と Oracle8i
O90 Oracle9i
SYC Sybase Adaptive Server Enterprise
構文
PWDialog = value
パラ メ ー タ
value
説明
実行時に PowerBuilder ア プ リ ケーシ ョ ン でパ ス ワ ー ド が
期限切れです ダ イ ア ロ グ ボ ッ ク ス を表示 し 、 ユーザに対
し て有効期限の切れた ロ グ イ ン パ ス ワ ー ド を 変更す る よ
う に求め る か ど う か を指定す る 値。以下のいずれかの値を
指定 し ます。
• 0 （デ フ ォ ル ト ） 実行時にパ ス ワ ー ド が期限切れです
ダ イ ア ロ グ ボ ッ ク ス を表示 し ません。
• 1 実 行時 に パ ス ワ ー ド が 期 限 切 れ で す ダ イ ア ロ グ
ボ ッ ク ス を表示 し 、 ユーザに対 し て有効期限の切れた
パ ス ワ ー ド を変更す る よ う に求め ます。
デフ ォル ト 値
PWDialog = 0
解説
設定が必要な場合 PWDialog を 1 に設定 し 、実行可能ア プ リ ケーシ ョ
ン でパ ス ワ ー ド が期限切れです ダ イ ア ロ グ ボ ッ ク ス が表示 さ れ る よ
う にす る と 、 パ ス ワ ー ド の有効期限が切れてい る ため、 変更が必要で
あ る こ と を ユーザに通知す る のに便利です。
設定後の処理 実行時に PowerBuilder アプ リ ケーシ ョ ン でパ ス ワー ド
が期限切れです ダ イ ア ロ グ ボ ッ ク ス を 表示す る 場合、 ユーザに対 し
て、ロ グ イ ン ID の有効期限が切れてい る ために新 し いパ ス ワ ー ド の設
定 が 必 要 で あ る こ と が 通知 さ れ ま す。 た と え ば、 Adaptive Server
Enterprise の場合、 sp_password シ ス テ ム ス ト ア ド プ ロ シージ ャ を実行
し て新 し いパ ス ワ ー ド を設定 し ま す。パ ス ワー ド の変更が完了 し た ら 、
デー タ ベース に接続で き る よ う にな り ま す。
140
PowerBuilder
第1章
DBParm パ ラ メ ー タ
ユーザが、 パ ス ワ ー ド を変更 し ない ま ま で ［キ ャ ン セル］ ボ タ ン を ク
リ ッ ク し てパ ス ワ ー ド が期限切れです ダ イ ア ロ グ ボ ッ ク ス を 閉 じ た
場合は、 デー タ ベー ス 接続は失敗 し 、 パ ス ワー ド の期限切れ を知 ら せ
る メ ッ セージが表示 さ れ ま す。
例
実行時に PowerBuilder アプ リ ケーシ ョ ン で必要な場合にパ ス ワー ド が
期限切れです ダ イ ア ロ グボ ッ ク ス が表示 さ れ る よ う にす る には、 以下
の操作を行い ま す。
PWDialog の設定値は、 開発環境では無
効ですが、 デー タ ベー ス プ ロ フ ァ イ ルで設定す る と 、 対応す る
PowerScript 構文が ［プ レ ビ ュ ー］ タ ブに生成 さ れ る ため、 そ こ か
ら 構文を ア プ リ ケーシ ョ ン ス ク リ プ ト へ コ ピ ーす る こ と がで き ま
す。 DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク ス の ［接続］ タ ブで、
［パ ス ワ ー ド の期限切れの時ダ イ ア ロ グ を表示］ チ ェ ッ ク ボ ッ ク ス
（SYC 接続の場合） ま た は ［パ ス ワ ー ド 期限切れ ダ イ ア ロ グ の表
示］ チ ェ ッ ク ボ ッ ク ス （Oracle 接続の場合） を オ ン に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に次の よ う に入力 し ま す。
SQLCA.DBParm = "PWDialog = 1"
PWEncrypt
機能
PWEncrypt に は、 PowerBuilder か ら Sybase Adaptive Server Enterprise
デー タ ベー ス に接続す る 際に Open Client に自動的にパ ス ワ ー ド を 暗
号化 さ せ る か ど う か を指定 し ま す。
PWEncrypt を指定す る タ イ ミ ン グ
PWEncrypt DBParm パ ラ メ ー タ は、PowerBuilder か ら デー タ ベース に接
続す る 前に指定 し ま す。
対象
SYC Sybase Adaptive Server Enterprise
構文
PWEncrypt = 'value'
接続 リ フ ァ レ ン ス
141
QualifyPublic
パラ メ ー タ
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 プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ネ ッ ト ワ ー ク ］ タ ブで、 ［パ ス ワ ー ド の暗号化］ チ ェ ッ ク
ボ ッ ク ス を オ フ に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "PWEncrypt='No'"
QualifyPublic
機能
パブ リ ッ ク ス キーマ ま たはユーザ グループに属す Oracle シ ノ ニ ム に
付加 さ れた PUBLIC 修飾子が、 SQL Select テーブル リ ス ト 内に保持 さ
れ る よ う に指定 し ま す。
QualifyPublic を指定す る タ イ ミ ン グ
QualifyPublic DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベース に
接続す る 前に指定 し ま す。
対象
O73 Oracle 7.3
O84 Oracle 8.x と Oracle8i
O90 Oracle9i
構文
QualifyPublic = value
142
PowerBuilder
第1章
パラ メ ー タ
value
DBParm パ ラ メ ー タ
説明
PUBLIC 修飾子が SQL Select テーブル リ ス ト 内に保持 さ れ
る よ う に指定 し ます。 以下のいずれかの値を指定 し ます。
• 0 （デフ ォ ル ト ） PUBLIC 修飾子を保持 し ません。
• 1 PUBLIC 修飾子 を保持 し ます。
デ フ ォル ト 値
QualifyPublic = 0
解説
PowerBuilder のデフ ォ ル ト 動作に よ り 、PUBLIC 修飾子を破棄 し て生成
済みの SQL 文でオブジ ェ ク ト 参照を一般化す る こ と がで き 、 開発デー
タ ベー ス イ ン ス タ ン ス か ら プ ロ ダ ク シ ョ ン デー タ ベー ス に ア プ リ
ケーシ ョ ン を容易に配布で き ま す。 ただ し 、 一部のデー タ ウ ィ ン ド ウ
オ ブ ジ ェ ク ト では、 PUBLIC 修飾子が存在 し な い場合は PowerBuilder
拡張属性 と シ ノ ニ ム の関連付け を解除 し 、 PowerBuilder 拡張属性が使
用 さ れ る のを回避 し ま す。 QualifyPublic DBParm を使 う と 、 PUBLIC 修
飾子を保持す る 必要があ る か ど う か を指定で き ま す。
例
PUBLIC 修飾子が SQL Select テーブル リ ス ト 内に保持 さ れ る よ う に指
定す る には、 以下の操作を行い ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［シ ス テ ム］ タ ブ で、 ［パ ブ リ ッ ク シ ノ ニ ム を 修飾す る ］
チ ェ ッ ク ボ ッ ク ス を オ ンに し ま す。
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
デー タ ベース プ ロ フ ァ イル
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "QualifyPublic = 1"
Release
機能
PowerBuilder ア プ リ ケーシ ョ ン の接続先 と な る SQL Server 10/11 ま た
は Adaptive Server Enterprise デー タ ベー ス のバージ ョ ン と 、 使用 さ れ る
Open Client Client-Library （CT-Lib） を指定 し ま す。
Release を指定す る タ イ ミ ン グ
Release の値は、 PowerBuilder か ら デー タ ベー ス に接続す る 前に指定 し
ま す。
対象
SYC Sybase Adaptive Server Enterprise
構文
Release = 'value'
接続 リ フ ァ レ ン ス
143
Release
パラ メ ー タ
value
説明
PowerBuilder ア プ リ ケーシ ョ ン の接続先 と な る SQL Server
10/11 ま たは Adaptive Server Enterprise デー タ ベー ス のバー
ジ ョ ン と 、 使用 さ れ る Open Client CT-Lib を 指定 し ま す。
以下のいずれかの値を指定 し ます。
• 10.x SQL Server 10 に接続 し 、 CT-Lib 10.x を使用 し ま
す。
• 11 SQL Server 11 に接続 し 、CT-Lib 11.x を使用 し ます。
• 11.5 Adaptive Server Enterprise 11.5 に 接 続 し 、 CT-Lib
11.x を使用 し ます。
• 12 Adaptive Server Enterprise 12 に接続 し 、 CT-Lib 11.x、
12.x を使用 し ます。
• 12.5 Adaptive Server Enterprise 12.5 に 接続 し 、 CT-Lib
12.5 を使用 し ます。
デフ ォル ト 値
なし
解説
設定が必要な場合 一部の機能は、 関連のあ る Open Client ソ フ ト ウ ェ
ア を 使 用 し て、 指 定 さ れ た バ ー ジ ョ ン の SQL Server 10/11 ま た は
Adaptive Server Enterprise デー タ ベー ス に ア ク セ ス す る と き に のみサ
ポー ト さ れ ま す。 た と えば、 ア プ リ ケーシ ョ ン でネ ッ ト ワ ー ク ベー ス
の セ キ ュ リ テ ィ ま た はデ ィ レ ク ト リ サー ビ ス を 利用す る には、 Open
Client 11.x 以降を使用 し ていなければな り ま せん。
し たがっ て、 PowerBuilder で Open Client 11.x セキ ュ リ テ ィ お よ びデ ィ
レ ク ト リ サー ビ ス を サ ポ ー ト す る DBParm パ ラ メ ー タ を 使用す る に
は、Release を '11' ま たはそれ以上に設定す る 必要があ り ま す。Adaptive
Server Enterprise 12.5 で サ ポ ー ト さ れ て い る 新機能 を 利用す る に は、
Release を '12.5' に設定す る 必要があ り ま す。
例
PowerBuilder ア プ リ ケーシ ョ ン が Open Client CT-Lib 12.5 の動作を使用
し て Adaptive Server Enterprise 12.5 デー タ ベース にア ク セ ス す る よ う に
指定す る には、 以下の操作を行い ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［接続］ タ ブ で、 ［ リ リ ー ス ］ ド ロ ッ プ ダ ウ ン リ ス ト の
「12.5」 を選択 し ま す。
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
デー タ ベース プ ロ フ ァ イル
PowerBuilder ス ク リ プ
ト に次の よ う に入力 し ま す。
SQLCA.DBParm = "Release = '12'"
144
PowerBuilder
第1章
DBParm パ ラ メ ー タ
ReleaseConnectionOption
機能
接続 の 制御 を 解放す る と き の EAServer の 動作 を 指定す る 値。 こ の
DBParm パ ラ メ ー タ が適用 さ れ る のは、 PowerBuilder カ ス タ ム ク ラ ス
ユーザ オブ ジ ェ ク ト が EAServer コ ン ポーネ ン ト と し て配布 さ れ る 場
合だけです。
対象
JDB JDBC
ODBC
O73 Oracle 7.3
O84 Oracle 8.x と Oracle8i
O90 Oracle9i
SYJ Sybase Adaptive Server Enterprise
構文
ReleaseConnectionOption = 'value'
パラ メ ー タ
value
説明
接続の制御を解放す る と き の EAServer の動作を指定す る
値。 以下のいずれかの値を指定 し ます。
• JAG_CM_UNUSED （デ フ ォ ル ト ） キ ャ ッ シ ュ か ら の接
続は キ ャ ッ シ ュ に戻 さ れ、 キ ャ ッ シ ュ 外で作成 さ れた
接続は閉 じ ら れ、 破棄 さ れます。
• JAG_CM_DROP 接続は強制的に閉 じ ら れ、 割 り 当てが
解除 さ れます。 接続が キ ャ ッ シ ュ か ら の場合は、新 し い
接続がその位置に作成 さ れます。
デ フ ォル ト 値
ReleaseConnectionOption = 'JAG_CM_UNUSED'
解説
UAG_CM_DROP を使用す る と 、エ ラ ーに よ っ て接続が使用不可にな っ
た と き にそ の接続が破棄 さ れ ま す。 こ のパ ラ メ ー タ は、 動的に設定す
る こ と がで き ま せん。 接続の確立時に設定 さ れた値は、 接続が切断す
る ま で有効です。
接続 リ フ ァ レ ン ス
145
RPCRebind
SYJ イ ン タ フ ェ ースの使用
Sybase EAServer は、 わずかに異な る バージ ョ ン の CT-Lib ソ フ ト ウ ェ
ア を使用 し ま す。 し たが っ て、実行時に、Adaptive Server Enterprise デー
タ ベ ー ス に 接続す る に は SYC で は な く SYJ デー タ ベー ス イ ン タ
フ ェ ース を使用す る 必要が あ り ま す。 SYJ の DB プ ロ フ ァ イ ル設定 ダ
イ ア ロ グ ボ ッ ク ス を使用す る と 、 適切な接続パ ラ メ ー タ が設定 さ れ、
構文を ［プ レ ビ ュ ー］ タ ブか ら ト ラ ン ザ ク シ ョ ン オブ ジ ェ ク ト の ス ク
リ プ ト に コ ピーで き ま す。
ただ し 、 PowerBuilder 開発環境か ら デー タ ベー ス に接続す る 場合には
SYJ イ ン タ フ ェ ー ス を 使用で き ま せん。 し たが っ て、 開発段階で （ コ
ン ポーネ ン ト が EAServer に配布 さ れ る 前に）、 SYC を使用 し てデー タ
ベース に接続す る 必要があ り ま す。
PowerBuilder を使用 し て EAServer コ ン ポーネ ン ト を作成す る 方法につ
いては、 『ア プ リ ケーシ ョ ン テ ク ニ ッ ク 』 マニ ュ ア ルを 参照 し て く だ
さ い。
例
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク ス の ［EAServer］ タ ブで、 ［接
続解放オプ シ ョ ン］ ド ロ ッ プ ダ ウ ン リ ス ト の 「JAG_CM_DROP」 を選
択 し ま す。 ReleaseConnectionOption DBParm パ ラ メ ー タ の PowerScript
構文が、 次の よ う に ［プ レ ビ ュ ー］ タ ブに表示 さ れ ま す。
SQLCA.dbParm = "ReleaseConnectionOption =
'JAG_CM_DROP'"
こ の構文を ［プ レ ビ ュ ー］ タ ブか ら ス ク リ プ ト に コ ピー し ま す。
関連項目
CacheName
GetConnectionOption
UseContextObject
RPCRebind
機能
リ モー ト プ ロ シージ ャ コ ール （RPC） パ ラ メ ー タ が再バ イ ン ド さ れ る
よ う にす る か ど う か を指定 し ま す。
RPCRebind を指定する タ イ ミ ン グ
バ ッ ク エ ン ド DBMS が PacketSize を サ ポ ー ト す る 場合、 RPCRebind
DBParm パ ラ メ ー タ は、 デー タ ベース に接続す る 前に指定 し ま す。
対象
146
ODBC
PowerBuilder
第1章
構文
DBParm パ ラ メ ー タ
RPCRebind = value
パラ メ ー タ
value
説明
RPC パ ラ メ ー タ が再バ イ ン ド さ れ る よ う にす る か ど う か を
指定 し ま す。 以下のいずれかの値を指定 し ま す。
• 0 （デ フ ォ ル ト ） バ イ ン ド さ れた変数を使用 し て、 必要な
バ イ ン ド 情報をすべて確認 し ま す。
• 1 パ ラ メ ー タ を 再バ イ ン ド し 、 デー タ ベー ス か ら 返 さ れ
た パ ラ メ ー タ 情報 を 使用 し て パ ラ メ ー タ を バ イ ン ド し ま
す。
デ フ ォル ト 値
RPCRebind = 0
解説
RPC コ ールを サポー ト す る DBMS の場合、 PowerBuilder はパ ラ メ ー タ
にバ イ ン ド さ れてい る 変数のサ イ ズに基づいて、 コ ール用のパ ラ メ ー
タ をバ イ ン ド し ま す。
ド ラ イ バのなかには、 パ ラ メ ー タ の再バ イ ン ド を必要 と す る も の も あ
り ま す。 こ のため、 パ ラ メ ー タ サ イ ズ （バ ッ ク エ ン ド デー タ ベー ス か
ら 返 さ れた も の） が変数サ イ ズのかわ り に使用 さ れ ま す。 こ の再バ イ
ン ド が失敗 し た場合は、 エ ラ ーが発生 し た り 文字列パ ラ メ ー タ が切 り
捨て ら れ る こ と があ り ま す。 た だ し 、 バ イ ン ド に よ る 変数サ イ ズの反
映が常に予期 さ れ る ド ラ イ バ も あ り ま す。 RPCRebind パ ラ メ ー タ を使
う と 、 RPC 実行時にパ ラ メ ー タ が再バ イ ン ド さ れ る よ う にす る か ど う
か を指定で き ま す。
例
RPC パ ラ メ ー タ が再バ イ ン ド さ れ る よ う にす る か ど う か を指定す る に
は、 以下の操作を行い ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ ト ラ ン ザ ク シ ョ ン］ タ ブの ［RPC 再バ イ ン ド ］ チ ェ ッ ク
ボ ッ ク ス を オ ン に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "RPCRebind = 1"
Scroll
機能
接続 リ フ ァ レ ン ス
PowerBuilder か ら Informix デー タ ベー ス に接続す る と き に、 ス ク ロ ー
ル カ ー ソ ル を 使用す る こ と を 指定す る に は 以下 の よ う に し ま す。
Informix テーブルか ら 行を フ ェ ッ チす る と き に、 ス ク ロ ールカー ソ ル
を使用す る と 、 次の行、 前の行、 先頭の行、 最後の行を フ ェ ッ チで き
ま す。
147
Scroll
デフ ォ ル ト では、 Informix デー タ ベース と の接続で ス ク ロ ール カー ソ
ルを使用 し ま せん。
対象
IN9 Informix
構文
Scroll = value
パラ メ ー タ
value
説明
PowerBuilder か ら Informix デー タ ベー ス に接続す る
と き に、 ス ク ロ ール カー ソ ル を 使用す る こ と を 指定
す る には以下の よ う に し ます。以下のいずれかの値を
指定 し ます。
• 0 （デフ ォ ル ト ) ス ク ロ ール カー ソ ルを使用 し ま
せん。
• 1 ス ク ロ ール カー ソ ルを使用 し ます。
デフ ォル ト 値
Scroll = 0
例
PowerBuilder か ら Informix デー タ ベー ス に接続す る と き に、 ス ク ロ ー
ル カー ソ ルを使用す る こ と を指定す る には以下の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ ト ラ ンザ ク シ ョ ン］ タ ブの ［ス ク ロ ール カー ソ ルの使用］
チ ェ ッ ク ボ ッ ク ス をオ ン に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で次の よ う に入力 し ま す。
アプ リ
SQLCA.dbParm = "Scroll = 1"
148
PowerBuilder
第1章
DBParm パ ラ メ ー タ
Sec_Channel_Bind
機能
Sec_Channel_Bind は、 PowerBuilder か ら Open Client を経由 し て Sybase
Adaptive Server Enterprise デー タ ベース にア ク セ スす る と き の、 ネ ッ ト
ワ ー ク ベー ス のセ キ ュ リ テ ィ サー ビ ス の ロ グ イ ン 認証 を サポー ト す
る DBParm パ ラ メ ー タ の う ちの 1 つです。 ほかの ロ グ イ ン認証 DBParm
パ ラ メ ー タ については、 「関連項目」 を参照 し て く だ さ い。
Sec_Channel_Bind は、 使用 し てい る 接続のセ キ ュ リ テ ィ メ カ ニズ ム が
チ ャ ネル バ イ ンデ ィ ン グ を実行す る か ど う か を制御 し ま す。
Sec_Channel_Bind が 1 に設定 さ れてい る 場合、Sybase Open Client ClientLibrary （CT-Lib） と サーバの両方が、 接続の前にセ キ ュ リ テ ィ メ カ ニ
ズ ムに対 し て ネ ッ ト ワ ー ク チ ャ ネル識別子を提供 し ま す。 こ のチ ャ ネ
ル識別子には、 ク ラ イ ア ン ト お よ びサーバのネ ッ ト ワー ク ア ド レ ス が
格納 さ れてい ま す。
Sec_Channel_Bind が 0 （デフ ォ ル ト ） に設定 さ れて い る 場合、 チ ャ ネ
ルバ イ ンデ ィ ン グは実行 さ れ ま せん。
Sec_Channel_Bind DBParm パ ラ メ ー タ は、PowerBuilder か ら デー タ ベー
ス に接続す る 前に指定 し ま す。
サー ド パーテ ィ のセキ ュ リ テ ィ メ カ ニズムの使用
Sybase が Open Client セ キ ュ リ テ ィ サー ビ ス で テ ス ト 済みの サー ド
パーテ ィ のセ キ ュ リ テ ィ メ カ ニ ズ ム お よ びオペ レ ーテ ィ ン グ シ ス テ
ム プ ラ ッ ト フ ォ ームの詳細については、 Open Client の ド キ ュ メ ン ト を
参照 し て く だ さ い。
対象
SYC Sybase Adaptive Server Enterprise
構文
Sec_Channel_Bind = value
パラ メ ー タ
value
デ フ ォル ト 値
接続 リ フ ァ レ ン ス
説明
使用 し てい る 接続のセ キ ュ リ テ ィ メ カ ニ ズ ム がチ ャ ネル
バ イ ンデ ィ ン グ を実行す る か ど う か を指定す る値。以下の
いずれかの値 を指定 し ます。
• 0 （デ フ ォ ル ト ） チ ャ ネル バ イ ンデ ィ ン グ を実行 し ま
せん。 ま た、 'No' も し く は 'False' を こ の値に指定す
る こ と も で き ます。
• 1 チ ャ ネル バ イ ン デ ィ ン グ を 実行 し ま す。 CT-Lib と
サーバの両方が、 接続の セキ ュ リ テ ィ メ カ ニ ズ ム に対
し てチ ャ ネル識別子を提供 し ます。 ま た、 'Yes' も し く
は 'True' を こ の値に指定す る こ と も で き ま す。
Sec_Channel_Bind = 0
149
Sec_Channel_Bind
解説
CyberSafe Kerberos ではサポー ト さ れ ま せん 使 用 し て い る セ キ ュ リ
テ ィ メ カ ニ ズ ム が CyberSafe Kerberos の場合、 Sec_Channel_Bind はサ
ポー ト さ れ ま せん。
Release DBParm の設定 Sec_Channel_Bind を有効にす る には、 Release
DBParm パ ラ メ ー タ に '11'、 '11.5'、 '12'、 '12.5' のいずれか を設定 し て、
ア プ リ ケ ー シ ョ ン が 適切 な バ ー ジ ョ ン の Sybase Open Client ClientLibrary （CT-Lib） の動作を使用す る こ と を指定す る 必要があ り ま す。
使用のための要件 Sec_Channel_Bind ま たは、 Open Client を サポー ト
し てい る ほかの DBParm パ ラ メ ー タ を使用す る には、 PowerBuilder ア
プ リ ケ ーシ ョ ン で セ キ ュ リ テ ィ サー ビ ス を 使用す る た めの一定の要
件を満た し てい る 必要があ り ま す。 詳細については、 『デー タ ベース と
の接続』 マニ ュ アルを参照 し て く だ さ い。
対応す る CT-Lib 接続プ ロ パテ ィ Sec_Channel_Bind に 値 を 指 定 す る
と 、 CS_SEC_CHANBIND と い う 名前の、 対応す る Sybase CT-Lib 接続
プ ロ パテ ィ が設定 さ れ ま す。
例
使用 し て い る 接続の セ キ ュ リ テ ィ メ カ ニ ズ ム がチ ャ ネ ルバ イ ン デ ィ
ン グ を実行す る こ と を指定す る には、 以下の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［セ キ ュ リ テ ィ ］ タ ブ の ［チ ャ ネ ル バ イ ン デ ィ ン グ有効］
チ ェ ッ ク ボ ッ ク ス をオ ン に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に以下を入力 し ま す。
SQLCA.DBParm = "Sec_Channel_Bind = 1"
関連項目
150
Release
Sec_Cred_Timeout
Sec_Delegation
Sec_Keytab_File
Sec_Mechanism
Sec_Mutual_Auth
Sec_Network_Auth
Sec_Server_Principal
Sec_Sess_Timeout
PowerBuilder
第1章
DBParm パ ラ メ ー タ
Sec_Confidential
機能
Sec_Confidential は、 PowerBuilder か ら Open Client を 経由 し て Sybase
Adaptive Server Enterprise デー タ ベース にア ク セ スす る と き の、 ネ ッ ト
ワ ー ク ベー ス の セ キ ュ リ テ ィ サー ビ ス の パ ケ ッ ト 単位の セ キ ュ リ
テ ィ を サポー ト す る DBParm パ ラ メ ー タ の う ちの 1 つです。 ほかのパ
ケ ッ ト 単位のセ キ ュ リ テ ィ DBParm パ ラ メ ー タ につい ては、 「関連項
目」 を参照 し て く だ さ い。
Sec_Confidential は、転送デー タ が暗号化 さ れ る か ど う か を制御 し ま す。
Sec_Confidential が 1 に設定 さ れてい る 場合、 サーバに送信 さ れ る すべ
ての リ ク エ ス ト 、 お よ びサーバか ら 返 さ れたすべての結果が暗号化 さ
れ ま す。
Sec_Confidential が 0 （デフ ォ ル ト ） に設定 さ れてい る 場合、 転送デー
タ は暗号化 さ れ ま せん。
Sec_Confidential DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー
ス に接続す る 前に指定 し ま す。
サー ド パーテ ィ のセキ ュ リ テ ィ メ カ ニズムの使用
Sybase が Open Client セ キ ュ リ テ ィ サー ビ ス で テ ス ト 済みの サー ド
パーテ ィ のセ キ ュ リ テ ィ メ カ ニ ズ ム お よ びオペ レ ーテ ィ ン グ シ ス テ
ム プ ラ ッ ト フ ォ ームの詳細については、 Open Client の ド キ ュ メ ン ト を
参照 し て く だ さ い。
対象
SYC Sybase Adaptive Server Enterprise
構文
Sec_Confidential = value
パラ メ ー タ
value
デ フ ォル ト 値
接続 リ フ ァ レ ン ス
説明
転送デー タ が暗号化 さ れ る か ど う か を指定す る値。以下の
いずれかの値 を指定 し ます。
• 0 （デ フ ォ ル ト ） 転送デー タ を 暗号化 し ま せん。 ま た、
'No' も し く は 'False' を こ の値に指定す る こ と も で き
ます。
• 1 転送デー タ を暗号化 し ます。 サーバに送信 さ れ る リ
ク エ ス ト お よ びサーバか ら 返 さ れた結果は暗号化 さ れ
ます。 ま た、 'Yes' も し く は 'True' を こ の値に指定す
る こ と も で き ます。
Sec_Confidential = 0
151
Sec_Confidential
解説
設定が必要な場合 暗号化を行 う と 、 パブ リ ッ ク ネ ッ ト ワー ク を介 し
て、 セ キ ュ リ テ ィ が設定 さ れていないサーバへデー タ を送信す る 場合
に、 自 分 の デ ー タ を 保 護 で き ま す。 ネ ッ ト ワ ー ク 環 境 に お い て、
Sec_Confidential を 1 に設定すれば、 サーバに送信 さ れ る すべての リ ク
エ ス ト 、 お よ びサーバか ら 返 さ れたすべての結果が暗号化 さ れ る こ と
が保証 さ れ ま す。
Release DBParm の設定 Sec_Confidential を 有効 に す る に は、 Release
DBParm パ ラ メ ー タ に '11'、 '11.5'、 '12'、 '12.5' のいずれか を設定 し て、
ア プ リ ケ ー シ ョ ン が 適切 な バ ー ジ ョ ン の Sybase Open Client ClientLibrary （CT-Lib） の動作を使用す る こ と を指定す る 必要があ り ま す。
使用のための要件 Sec_Confidential ま たは、 Open Client セ キ ュ リ テ ィ
サービ ス を サポー ト し てい る ほかの DBParm パ ラ メ ー タ を使用す る に
は、 PowerBuilder アプ リ ケーシ ョ ン でセ キ ュ リ テ ィ サービ ス を使用す
る ための一定の要件を満た し てい る 必要があ り ま す。詳細については、
『デー タ ベース と の接続』 マニ ュ アル を参照 し て く だ さ い。
対応す る CT-Lib 接続プ ロ パテ ィ Sec_Confidential に値を指定す る と 、
CS_SEC_CONFIDENTIALITY と い う 名前の、対応す る Sybase CT-Lib 接
続プ ロ パテ ィ が設定 さ れ ま す。
例
転送デー タ が暗号化 さ れ る こ と を指定す る には、以下の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［セ キ ュ リ テ ィ ］ タ ブ の ［すべての結果 を暗号化］ チ ェ ッ
ク ボ ッ ク ス をオ ン に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に以下を入力 し ま す。
SQLCA.DBParm = "Sec_Confidential = 1"
関連項目
152
Release
Sec_Data_Integrity
Sec_Data_Origin
Sec_Replay_Detection
Sec_Seq_Detection
PowerBuilder
第1章
DBParm パ ラ メ ー タ
Sec_Cred_Timeout
機能
Sec_Cred_Timeout は、 PowerBuilder か ら Open Client を経由 し て Sybase
Adaptive Server Enterprise デー タ ベース にア ク セ スす る と き の、 ネ ッ ト
ワ ー ク ベー ス のセ キ ュ リ テ ィ サー ビ ス の ロ グ イ ン 認証 を サポー ト す
る DBParm パ ラ メ ー タ の う ちの 1 つです。 ほかの ロ グ イ ン認証 DBParm
パ ラ メ ー タ については、 「関連項目」 を参照 し て く だ さ い。
一部の セ キ ュ リ テ ィ メ カ ニ ズ ム で は、 ア プ リ ケ ーシ ョ ン は、 ネ ッ ト
ワ ー ク ベー ス の ロ グ イ ン 認証 を使用す る 接続に対す る 認証の タ イ ム
ア ウ ト 値を設定で き ま す。Sec_Cred_Timeout では、ユーザのネ ッ ト ワ ー
ク 認証の有効期限が切れ、 無効にな る ま での残 り の秒数が指定 さ れ ま
す。 ユーザはネ ッ ト ワ ー ク に ロ グ イ ンす る と き にネ ッ ト ワ ー ク 認証を
取得 し ま す。
デフ ォ ル ト では、 Sec_Cred_Timeout に認証の タ イ ム ア ウ ト が指定 さ れ
ま せん。 し たが っ て、 認証の タ イ ム ア ウ ト は設定 さ れ ま せん。
Sec_Cred_Timeout DBParm パ ラ メ ー タ は、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 は、 イ ン ス ト ール時のデ
フ ォ ル ト の認証 タ イ ム ア ウ ト 値を上書 き で き ま せん。
接続 リ フ ァ レ ン ス
153
Sec_Cred_Timeout
Release DBParm の設定 Sec_Cred_Timeout を有効にす る には、 Release
DBParm パ ラ メ ー タ に '11'、 '11.5'、 '12'、 '12.5' のいずれか を設定 し て、
ア プ リ ケ ー シ ョ ン が 適切 な バ ー ジ ョ ン の Sybase Open Client ClientLibrary （CT-Lib） の動作を使用す る こ と を指定す る 必要があ り ま す。
使用のための要件 Sec_Cred_Timeout ま た は、 Open Client セ キ ュ リ
テ ィ サービ ス を サポー ト し てい る ほかの DBParm パ ラ メ ー タ を使用す
る には、 PowerBuilder ア プ リ ケーシ ョ ン でセ キ ュ リ テ ィ サービ ス を使
用す る ための一定の要件を満た し てい る 必要が あ り ま す。 詳細につい
ては、 『デー タ ベース と の接続』 マニ ュ アル を参照 し て く だ さ い。
対応す る CT-Lib 接続プ ロ パテ ィ Sec_Cred_Timeout に 値 を 指 定 す る
と 、 CS_SEC_CREDTIMEOUT と い う 名前の、 対応す る Sybase CT-Lib
接続プ ロ パテ ィ が設定 さ れ ま す。
例
ユーザのネ ッ ト ワ ー ク 認証が 120 秒 （2 分） 後に期限切れにな る よ う
に指定す る には、 以下の よ う に し ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［セ キ ュ リ テ ィ ］ タ ブ の ［ア カ ウ ン ト 情報 タ イ ム ア ウ ト ］
ボ ッ ク ス で、 以下の入力を行い ま す。
デー タ ベース プ ロ フ ァ イル
120
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に以下を入力 し ま す。
SQLCA.DBParm = "Sec_Cred_Timeout = 120; Release =
11"
関連項目
154
Release
Sec_Channel_Bind
Sec_Delegation
Sec_Keytab_File
Sec_Mechanism
Sec_Mutual_Auth
Sec_Network_Auth
Sec_Server_Principal
Sec_Sess_Timeout
PowerBuilder
第1章
DBParm パ ラ メ ー タ
Sec_Data_Integrity
機能
Sec_Data_Integrity は、 PowerBuilder か ら Open Client を経由 し て Sybase
Adaptive Server Enterprise デー タ ベース にア ク セ スす る と き の、 ネ ッ ト
ワ ー ク ベー ス の セ キ ュ リ テ ィ サー ビ ス の パ ケ ッ ト 単位の セ キ ュ リ
テ ィ を サポー ト す る DBParm パ ラ メ ー タ の う ちの 1 つです。 ほかのパ
ケ ッ ト 単位のセ キ ュ リ テ ィ DBParm パ ラ メ ー タ につい ては、 「関連項
目」 を参照 し て く だ さ い。
Sec_Data_Integrity は、使用 し てい る 接続のセキ ュ リ テ ィ メ カ ニ ズ ム が、
サーバ と の間で転送 さ れ る デー タ の整合性を チ ェ ッ ク す る か ど う か を
制御 し ま す。 Sec_Data_Integrity が 1 に設定 さ れてい る 場合、 セ キ ュ リ
テ ィ メ カ ニ ズ ム は、 転送中に内容が変更 さ れなか っ た こ と を確認す る
ためにすべてのパケ ッ ト を分析 し ま す。
Sec_Data_Integrity が 0 （デフ ォ ル ト ） に設定 さ れて い る 場合、 整合性
のチ ェ ッ ク は行われ ま せん。
Sec_Data_Integrity DBParm パ ラ メ ー タ は、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
155
Sec_Data_Integrity
解説
設定が必要な場合 使用 し て い る 接続のセ キ ュ リ テ ィ メ カ ニ ズ ム は、
ネ ッ ト ワ ー ク ベー ス の ロ グ イ ン認証 も 使用 し てい る と き にのみ、 デー
タ の 整 合 性 を チ ェ ッ ク で き ま す。 詳 細 に つ い て は、 Sybase Open
Client/Server のマニ ュ アル を参照 し て く だ さ い。
Release DBParm の設定 Sec_Data_Integrity を有効にす る には、 Release
DBParm パ ラ メ ー タ に '11'、 '11.5'、 '12'、 '12.5' のいずれか を設定 し て、
ア プ リ ケ ー シ ョ ン が 適切 な バ ー ジ ョ ン の Sybase Open Client ClientLibrary （CT-Lib） の動作を使用す る こ と を指定す る 必要があ り ま す。
使用のための要件 Sec_Data_Integrity ま た は、 Open Client セ キ ュ リ
テ ィ サービ ス を サポー ト し てい る ほかの DBParm パ ラ メ ー タ を使用す
る には、 PowerBuilder ア プ リ ケーシ ョ ン でセ キ ュ リ テ ィ サービ ス を使
用す る ための一定の要件を満た し てい る 必要が あ り ま す。 詳細につい
ては、 『デー タ ベース と の接続』 マニ ュ アル を参照 し て く だ さ い。
対応す る CT-Lib 接続プ ロ パテ ィ Sec_Data_Integrity に 値 を 指 定す る
と 、 CS_SEC_INTEGRITY と い う 名前の、 対応す る Sybase CT-Lib 接続
プ ロ パテ ィ が設定 さ れ ま す。
例
使用 し て い る 接続 の セ キ ュ リ テ ィ メ カ ニ ズ ム がデー タ の 整合性 を
チ ェ ッ ク す る こ と を指定す る には、 以下の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス で ［セ キ ュ リ テ ィ ］ タ ブ の ［デー タ 整合性の保証］ チ ェ ッ ク
ボ ッ ク ス を オ ン に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に以下を入力 し ま す。
SQLCA.DBParm = "Sec_Data_Integrity = 1; Release =
11"
関連項目
156
Release
Sec_Confidential
Sec_Data_Origin
Sec_Replay_Detection
Sec_Seq_Detection
PowerBuilder
第1章
DBParm パ ラ メ ー タ
Sec_Data_Origin
機能
Sec_Data_Origin は、 PowerBuilder か ら Open Client を 経由 し て Sybase
Adaptive Server Enterprise デー タ ベース にア ク セ スす る と き の、 ネ ッ ト
ワ ー ク ベー ス の セ キ ュ リ テ ィ サー ビ ス の パ ケ ッ ト 単位の セ キ ュ リ
テ ィ を サポー ト す る DBParm パ ラ メ ー タ の う ちの 1 つです。 ほかのパ
ケ ッ ト 単位のセ キ ュ リ テ ィ DBParm パ ラ メ ー タ につい ては、 「関連項
目」 を参照 し て く だ さ い。
Sec_Data_Origin は、 使用 し て い る 接続のセ キ ュ リ テ ィ メ カ ニ ズ ム が
デ ー タ の 作 成 元 の ス タ ン プ を 記 す か ど う か を 制 御 し ま す。
Sec_Data_Origin が 1 に設定 さ れてい る 場合、セ キ ュ リ テ ィ メ カ ニ ズ ム
は各パケ ッ ト に対 し 、 パケ ッ ト の作成元 と 内容を検証す る デジ タ ル署
名を付加 し ま す。
Sec_Data_Origin が 0 （デフ ォ ル ト ） に設定 さ れてい る 場合、 デー タ の
作成元の ス タ ン プは記 さ れ ま せん。
Sec_Data_Origin DBParm パ ラ メ ー タ は、 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
157
Sec_Delegation
解説
CyberSafe Kerberos ではサポー ト さ れ ま せん 使 用 し て い る セ キ ュ リ
テ ィ メ カ ニ ズ ム が CyberSafe Kerberos の場合、 Sec_Data_Origin は サ
ポー ト さ れ ま せん。
Release DBParm の設定 Sec_Data_Origin を 有効 に す る に は、 Release
DBParm パ ラ メ ー タ に '11'、 '11.5'、 '12'、 '12.5' のいずれか を設定 し て、
ア プ リ ケ ー シ ョ ン が 適切 な バ ー ジ ョ ン の Sybase Open Client ClientLibrary （CT-Lib） の動作を使用す る こ と を指定す る 必要があ り ま す。
使用のための要件 Sec_Data_Origin ま たは、 Open Client セ キ ュ リ テ ィ
サービ ス を サポー ト し てい る ほかの DBParm パ ラ メ ー タ を使用す る に
は、 PowerBuilder アプ リ ケーシ ョ ン でセ キ ュ リ テ ィ サービ ス を使用す
る ための一定の要件を満た し てい る 必要があ り ま す。詳細については、
『デー タ ベース と の接続』 マニ ュ アル を参照 し て く だ さ い。
対応す る CT-Lib 接続プ ロ パテ ィ Sec_Data_Origin に値を指定す る と 、
CS_SEC_DATAORIGIN と い う 名前の、 対応す る Sybase CT-Lib 接続プ
ロ パテ ィ が設定 さ れ ま す。
例
使用 し て い る 接続の セ キ ュ リ テ ィ メ カ ニ ズ ム がデー タ の作成元の ス
タ ン プ を記す こ と を指定す る には、 以下の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス で ［セ キ ュ リ テ ィ ］ タ ブ の ［パ ケ ッ ト の起点を検証］ チ ェ ッ
ク ボ ッ ク ス をオ ン に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に以下を入力 し ま す。
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 デー タ ベース にア ク セ ス す る と き の、 ネ ッ ト
ワ ー ク ベー ス のセ キ ュ リ テ ィ サー ビ ス の ロ グ イ ン 認証 を サポー ト す
る DBParm パ ラ メ ー タ の う ちの 1 つです。 ほかの ロ グ イ ン認証 DBParm
パ ラ メ ー タ については、 「関連項目」 を参照 し て く だ さ い。
158
PowerBuilder
第1章
DBParm パ ラ メ ー タ
ネ ッ ト ワ ー ク ベー ス の ロ グ イ ン 認証 を 使用 し て Sybase Open Server
ゲ ー ト ウ ェ イ に 接 続 し て い る ア プ リ ケ ー シ ョ ン に 対 し て、
Sec_Delegation は、 ゲー ト ウ ェ イ サーバが委任認証を使っ て リ モー ト
の SQL Server へ接続で き る か ど う か を制御 し ま す。 Sec_Delegation が
1 に設定 さ れてい る 場合、 ゲー ト ウ ェ イ は ク ラ イ ア ン ト の委任認証を
使 っ て リ モー ト サーバに接続で き ま す。 こ の場合、 リ モー ト サーバ
も 、ネ ッ ト ワ ー ク ベー ス の認証お よ び同一のセ キ ュ リ テ ィ メ カ ニ ズ ム
を使用 し てい る 必要があ り ま す。
Sec_Delegation が 0 （デフ ォ ル ト ） に設定 さ れてい る 場合、 ゲー ト ウ ェ
イ サーバは委任認証を使っ て リ モー ト サーバに接続で き ま せん。
Sec_Delegation DBParm パ ラ メ ー タ は、 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 はサポー
ト さ れ ま せん。
接続 リ フ ァ レ ン ス
159
Sec_Keytab_File
Release DBParm の設定 DS_Delegation を 有 効 に す る に は、 Release
DBParm パ ラ メ ー タ に '11'、 '11.5'、 '12'、 '12.5' のいずれか を設定 し て、
ア プ リ ケ ー シ ョ ン が 適切 な バ ー ジ ョ ン の Sybase Open Client ClientLibrary （CT-Lib） の動作を使用す る こ と を指定す る 必要があ り ま す。
使用のための要件 Sec_Delegation ま た は、 Open Client セ キ ュ リ テ ィ
サービ ス を サポー ト し てい る ほかの DBParm パ ラ メ ー タ を使用す る に
は、 PowerBuilder アプ リ ケーシ ョ ン でセ キ ュ リ テ ィ サービ ス を使用す
る ための一定の要件を満た し てい る 必要があ り ま す。詳細については、
『デー タ ベース と の接続』 マニ ュ アル を参照 し て く だ さ い。
対応す る CT-Lib 接続プ ロ パテ ィ Sec_Delegation に 値 を 指定す る と 、
CS_SEC_DELEGATION と い う 名前の、 対応す る Sybase CT-Lib 接続プ
ロ パテ ィ が設定 さ れ ま す。
例
Open Server ゲー ト ウ ェ イ が委任認証 を使っ て リ モー ト サーバに接続
で き る よ う にす る には、 以下の よ う に し ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［セ キ ュ リ テ ィ ］ タ ブ の ［委任 さ れ た ア カ ウ ン ト の使用］
チ ェ ッ ク ボ ッ ク ス をオ ン に し ま す。
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
デー タ ベース プ ロ フ ァ イル
PowerBuilder ス ク リ プ
ト に以下を入力 し ま す。
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 デー タ ベース にア ク セ ス す る と き の、 ネ ッ ト
ワ ー ク ベー ス のセ キ ュ リ テ ィ サー ビ ス の ロ グ イ ン 認証 を サポー ト す
る DBParm パ ラ メ ー タ の う ちの 1 つです。 ほかの ロ グ イ ン認証 DBParm
パ ラ メ ー タ については、 「関連項目」 を参照 し て く だ さ い。
160
PowerBuilder
第1章
DBParm パ ラ メ ー タ
Sec_Keytab_File は、 セ キ ュ リ テ ィ メ カ ニ ズ ム と し て Distributed
Computing Environment （DCE） Kerberos を使用 し てい る 、 ネ ッ ト ワ ー
ク ベース の ロ グ イ ン認証を要求す る 接続にのみ適用 さ れ ま す。 こ の
よ う な接続の場合に、 Sec_Keytab_File は DCE ユーザのセキ ュ リ テ ィ
キーが格納 さ れてい る キー タ ブ フ ァ イ ルの名前を指定 し ま す。
デー タ ベース プ ロ フ ァ イ ル ま たは PowerBuilder ア プ リ ケーシ ョ ン ス ク
リ プ ト で指定 さ れ る ロ グ イ ン ID が、現在ア プ リ ケーシ ョ ン を実行 し て
い る DCE ユーザのユーザ名 と 異な る 場合は、Sec_Keytab_File を設定す
る 必要があ り ま す。
Sec_Keytab_File DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー
ス に接続す る 前に指定 し ま す。
サー ド パーテ ィ のセキ ュ リ テ ィ メ カ ニズムの使用
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 で あ る と き にのみサポー ト さ れ ま す。
161
Sec_Keytab_File
設定が必要な場合 ア プ リ ケーシ ョ ン が、 現在ア プ リ ケーシ ョ ン を実
行 し てい る DCE ユーザのユーザ名 と は異な る ユーザ名 （ ロ グ イ ン ID）
を使っ てサーバに接続で き る よ う に し たい場合は、Sec_Keytab_File を、
該当す る ユーザのセ キ ュ リ テ ィ キーが格納 さ れて い る キー タ ブ フ ァ
イ ルの名前 を 指定す る よ う に設定 し ま す。 詳細につい ては、 『デー タ
ベース と の接続』 マニ ュ アルを参照 し て く だ さ い。
Release DBParm の設定 Sec_Keytab_File を 有 効 に す る に は、 Release
DBParm パ ラ メ ー タ に '11'、 '11.5'、 '12'、 '12.5' のいずれか を設定 し て、
ア プ リ ケ ー シ ョ ン が 適切 な バ ー ジ ョ ン の Sybase Open Client ClientLibrary （CT-Lib） の動作を使用す る こ と を指定す る 必要があ り ま す。
使用のための要件 Sec_Keytab_File ま たは、 Open Client セ キ ュ リ テ ィ
サービ ス を サポー ト し てい る ほかの DBParm パ ラ メ ー タ を使用す る に
は、 PowerBuilder アプ リ ケーシ ョ ン でセ キ ュ リ テ ィ サービ ス を使用す
る ための一定の要件を満た し てい る 必要があ り ま す。詳細については、
『デー タ ベース と の接続』 マニ ュ アル を参照 し て く だ さ い。
対応す る CT-Lib 接続プ ロ パテ ィ Sec_Keytab_File に値を指定す る と 、
CS_SEC_KEYTAB と い う 名前の、 対応す る Sybase CT-Lib 接続プ ロ パ
テ ィ が設定 さ れ ま す。
例
DCE キー タ ブ フ ァ イ ルの名前 と し て C:￥DCE_KEY を指定す る には、
以下の よ う に し ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［セ キ ュ リ テ ィ ］ タ ブ の ［Keytab フ ァ イ ル］ ボ ッ ク ス で、
以下の入力を行い ま す。
デー タ ベース プ ロ フ ァ イル
C:¥DCE_KEY
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に以下を入力 し ま す。
SQLCA.DBParm = "Sec_Keytab_File = 'C:¥DCE_KEY';
Release = 11"
関連項目
162
Release
Sec_Channel_Bind
Sec_Cred_Timeout
Sec_Delegation
Sec_Mechanism
Sec_Mutual_Auth
Sec_Network_Auth
Sec_Server_Principal
Sec_Sess_Timeout
PowerBuilder
第1章
DBParm パ ラ メ ー タ
Sec_Mechanism
機能
Sec_Mechanism は、 PowerBuilder か ら Open Client を 経由 し て Sybase
Adaptive Server Enterprise デー タ ベース にア ク セ スす る と き の、 ネ ッ ト
ワ ー ク ベー ス のセ キ ュ リ テ ィ サー ビ ス の ロ グ イ ン 認証 を サポー ト す
る DBParm パ ラ メ ー タ の う ちの 1 つです。 ほかの ロ グ イ ン認証 DBParm
パ ラ メ ー タ については、 「関連項目」 を参照 し て く だ さ い。
Open Client セ キ ュ リ テ ィ サービ ス を使用す る と き には、 要求 さ れた ド
ラ イ バ が ロ ー ド で き る よ う に、 Open Client/Open Server Configuration
ユーテ ィ リ テ ィ で、 使用す る セ キ ュ リ テ ィ メ カ ニズ ム の名前を指定す
る 必 要 が あ り ま す。 デ フ ォ ル ト の セ キ ュ リ テ ィ
メ カ ニ ズ ム は、
Configuration ユ ー テ ィ リ テ ィ で現在 ア ク テ ィ ブ に指定 さ れ て い る セ
キ ュ リ テ ィ メ カ ニ ズ ム です。
Sec_Mechanism を使 う と 、 デフ ォ ル ト の （ア ク テ ィ ブ な） メ カ ニ ズ ム
ではない、 Open Client/Open Server Configuration ユーテ ィ リ テ ィ で リ ス
ト さ れてい る セ キ ュ リ テ ィ メ カ ニズ ム名を指定で き ま す。
Sec_Mechanism DBParm パ ラ メ ー タ は、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
ユーテ ィ リ テ ィ で現在ア ク テ ィ ブに指定 さ れ て い る セ キ ュ リ テ ィ メ
カ ニ ズ ム 名です。 セ キ ュ リ テ ィ メ カ ニ ズ ム 名が指定 さ れ て い な い場
合、 接続を確立す る のにセキ ュ リ テ ィ サービ ス は使用 さ れ ま せん。
163
Sec_Mechanism
解説
設定が必要な場合 Sec_Mechanism は、 デフ ォ ル ト の （ア ク テ ィ ブな）
セキュ リ ティ メ カニズム ではない、Open Client/Open Server Configuration
ユーテ ィ リ テ ィ で指定 さ れ て い る セ キ ュ リ テ ィ メ カ ニ ズ ム を 使用す
る と き に設定 し ま す。 Open Client/Open Server Configuration ユーテ ィ リ
テ ィ の使い方につい て は、 Sybase Open Client/Server の 『設定ガ イ ド 』
マニ ュ アル を参照 し て く だ さ い。
Release DBParm の設定 Sec_Mechanism を 有 効 に す る に は、 Release
DBParm パ ラ メ ー タ に '11'、 '11.5'、 '12'、 '12.5' のいずれか を設定 し て、
ア プ リ ケ ー シ ョ ン が 適切 な バ ー ジ ョ ン の Sybase Open Client ClientLibrary （CT-Lib） の動作を使用す る こ と を指定す る 必要があ り ま す。
使用のための要件 Sec_Mechanism ま たは、 Open Client セキ ュ リ テ ィ
サービ ス を サポー ト し てい る ほかの DBParm パ ラ メ ー タ を使用す る に
は、 PowerBuilder アプ リ ケーシ ョ ン でセ キ ュ リ テ ィ サービ ス を使用す
る ための一定の要件を満た し てい る 必要があ り ま す。詳細については、
『デー タ ベース と の接続』 マニ ュ アル を参照 し て く だ さ い。
対応す る CT-Lib 接続プ ロ パテ ィ Sec_Mechanism に値 を 指定す る と 、
CS_SEC_MECHANISM と い う 名前の、 対応す る Sybase CT-Lib 接続プ
ロ パテ ィ が設定 さ れ ま す。
例
セキ ュ リ テ ィ メ カ ニ ズ ム名 と し て KERBEROS を指定す る には、 以下
の よ う に し ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［セキ ュ リ テ ィ ］ タ ブの ［セ キ ュ リ テ ィ 方式］ ボ ッ ク ス で、
以下の入力を行い ま す。
デー タ ベース プ ロ フ ァ イル
KERBEROS
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に以下を入力 し ま す。
SQLCA.DBParm = "Sec_Mechanism = 'KERBEROS'; Release
= 11"
関連項目
164
Release
Sec_Channel_Bind
Sec_Cred_Timeout
Sec_Delegation
Sec_Keytab_File
Sec_Mutual_Auth
Sec_Network_Auth
Sec_Server_Principal
Sec_Sess_Timeout
PowerBuilder
第1章
DBParm パ ラ メ ー タ
Sec_Mutual_Auth
機能
Sec_Mutual_Auth は、 PowerBuilder か ら Open Client を経由 し て Sybase
Adaptive Server Enterprise デー タ ベース にア ク セ スす る と き の、 ネ ッ ト
ワ ー ク ベー ス のセ キ ュ リ テ ィ サー ビ ス の ロ グ イ ン 認証 を サポー ト す
る DBParm パ ラ メ ー タ の う ちの 1 つです。 ほかの ロ グ イ ン認証 DBParm
パ ラ メ ー タ については、 「関連項目」 を参照 し て く だ さ い。
Sec_Mutual_Auth は、 使用 し てい る 接続のセ キ ュ リ テ ィ メ カ ニ ズ ム が
相互認証を実行す る か ど う か を制御 し ま す。Sec_Mutual_Auth が 1 に設
定 さ れてい る 場合、 サーバは、 接続の前にサーバのプ リ ン シプル名 と
その名前が認証 さ れてい る こ と の証明が格納 さ れた認証 ト ー ク ン を送
信す る こ と に よ っ て ク ラ イ ア ン ト に対 し て身元を証明す る 必要があ り
ま す。
Sec_Mutual_Auth が 0 （デフ ォ ル ト ） に設定 さ れてい る 場合、 相互認証
は実行 さ れ ま せん。
Sec_Mutual_Auth DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー
ス に接続す る 前に指定 し ま す。
サー ド パーテ ィ のセキ ュ リ テ ィ メ カ ニズムの使用
Sybase が Open Client セ キ ュ リ テ ィ サー ビ ス で テ ス ト 済みの サー ド
パーテ ィ のセ キ ュ リ テ ィ メ カ ニ ズ ム お よ びオペ レ ーテ ィ ン グ シ ス テ
ム プ ラ ッ ト フ ォ ームの詳細については、 Open Client の ド キ ュ メ ン ト を
参照 し て く だ さ い。
対象
SYC Sybase Adaptive Server Enterprise
構文
Sec_Mutual_Auth = value
パラ メ ー タ
value
接続 リ フ ァ レ ン ス
説明
使用 し てい る 接続の セ キ ュ リ テ ィ メ カ ニ ズ ム が相互
認証 を実行す る か ど う か を指定す る 値。 以下のいずれ
かの値を指定 し ます。
• 0 （デ フ ォ ル ト ） 相互認証 を 実行 し ま せん。 ま た、
'No' も し く は 'False' を こ の値に指定す る こ と も
で き ます。
• 1 相互認証を 実行 し ま す。 サーバは、 接続の前に
サーバ のプ リ ン シプル名 と そ の名前が認証 さ れて
い る こ と の証明が格納 さ れた認証 ト ー ク ン を 送信
す る こ と に よ っ て ク ラ イ ア ン ト に対 し て身元 を 証
明 す る 必 要 が あ り ま す。 ま た、 'Yes' も し く は
'True' を こ の値に指定す る こ と も で き ま す。
165
Sec_Mutual_Auth
デフ ォル ト 値
Sec_Mutual_Auth = 0
解説
Release DBParm の設定 Sec_Mutual_Auth を 有効にす る には、 Release
DBParm パ ラ メ ー タ に '11'、 '11.5'、 '12'、 '12.5' のいずれか を設定 し て、
ア プ リ ケ ー シ ョ ン が 適切 な バ ー ジ ョ ン の Sybase Open Client ClientLibrary （CT-Lib） の動作を使用す る こ と を指定す る 必要があ り ま す。
使用のための要件 Sec_Mutual_Auth ま たは、Open Client セ キ ュ リ テ ィ
サービ ス を サポー ト し てい る ほかの DBParm パ ラ メ ー タ を使用す る に
は、 PowerBuilder アプ リ ケーシ ョ ン でセ キ ュ リ テ ィ サービ ス を使用す
る ための一定の要件を満た し てい る 必要があ り ま す。詳細については、
『デー タ ベース と の接続』 マニ ュ アル を参照 し て く だ さ い。
対応す る CT-Lib 接続プ ロ パテ ィ Sec_Mutual_Auth に 値 を 指 定 す る
と 、 CS_SEC_MUTUALAUTH と い う 名前の、 対応す る Sybase CT-Lib
接続プ ロ パテ ィ が設定 さ れ ま す。
例
使用 し て い る 接続の セ キ ュ リ テ ィ メ カ ニ ズ ム が相互認証を 実行す る
こ と を指定す る には、 以下の よ う に し ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［セ キ ュ リ テ ィ ］ タ ブ の ［相互認証］ チ ェ ッ ク ボ ッ ク ス を
オ ン に し ま す。
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
デー タ ベース プ ロ フ ァ イル
PowerBuilder ス ク リ プ
ト に以下を入力 し ま す。
SQLCA.DBParm = "Sec_Mutual_Auth = 1 ; Release = 11"
関連項目
166
Release
Sec_Channel_Bind
Sec_Cred_Timeout
Sec_Delegation
Sec_Keytab_File
Sec_Mechanism
Sec_Network_Auth
Sec_Server_Principal
Sec_Sess_Timeout
PowerBuilder
第1章
DBParm パ ラ メ ー タ
Sec_Network_Auth
機能
Sec_Network_Auth は、PowerBuilder か ら Open Client を経由 し て Sybase
Adaptive Server Enterprise デー タ ベース にア ク セ スす る と き の、 ネ ッ ト
ワ ー ク ベー ス のセ キ ュ リ テ ィ サー ビ ス の ロ グ イ ン 認証 を サポー ト す
る DBParm パ ラ メ ー タ の う ちの 1 つです。 ほかの ロ グ イ ン認証 DBParm
パ ラ メ ー タ については、 「関連項目」 を参照 し て く だ さ い。
Sec_Network_Auth は、使用 し てい る 接続がネ ッ ト ワ ー ク ベー ス の ロ グ
イ ン認証を使用す る か ど う か を制御 し ま す。 Sec_Network_Auth が 1 に
設定 さ れてい る 場合、 セキ ュ リ テ ィ が設定 さ れた SQL Server に接続す
る と き に、 使用 し てい る 接続はネ ッ ト ワー ク ベース の ロ グ イ ン認証を
使用 し ま す。 ネ ッ ト ワ ー ク ベー ス の認証 と は、 指定 し たユーザ名がア
プ リ ケ ー シ ョ ン を 実行 し て い る 認証 さ れ た ユーザ で あ る こ と を、 セ
キ ュ リ テ ィ メ カ ニ ズ ム （ア プ リ ケーシ ョ ン ではな く ） が確認す る こ と
を意味 し ま す。
ア プ リ ケーシ ョ ン ではな く 、 セ キ ュ リ テ ィ メ カ ニ ズ ム がユーザ名 （ ロ
グ イ ン ID） を認証す る ので、 Sec_Network_Auth が 1 に設定 さ れてい る
場合は、 デー タ ベー ス プ ロ フ ァ イ ル ま た は PowerBuilder ア プ リ ケ ー
シ ョ ン ス ク リ プ ト で、 認証のために ロ グ イ ン パ ス ワ ー ド を入力す る 必
要は あ り ま せん。
Sec_Network_Auth が 0 （デフ ォ ル ト ） に設定 さ れてい る 場合、 使用 し
てい る 接続は、 サーバに接続す る ためにネ ッ ト ワ ー ク ベー ス の ロ グ イ
ン認証を使用 し ま せん。
Sec_Network_Auth DBParm パ ラ メ ー タ は、PowerBuilder か ら デー タ ベー
ス に接続す る 前に指定 し ま す。
サー ド パーテ ィ のセキ ュ リ テ ィ メ カ ニズムの使用
Sybase が Open Client セ キ ュ リ テ ィ サー ビ ス で テ ス ト 済みの サー ド
パーテ ィ のセ キ ュ リ テ ィ メ カ ニ ズ ム お よ びオペ レ ーテ ィ ン グ シ ス テ
ム プ ラ ッ ト フ ォ ームの詳細については、 Open Client の ド キ ュ メ ン ト を
参照 し て く だ さ い。
対象
SYC Sybase Adaptive Server Enterprise
構文
Sec_Network_Auth = value
接続 リ フ ァ レ ン ス
167
Sec_Network_Auth
パラ メ ー タ
value
説明
セキ ュ リ テ ィ が設定 さ れた SQL Server に接続す る と き に、
使用 し てい る 接続が ネ ッ ト ワ ー ク ベー ス の ロ グ イ ン認証
を使用す る か ど う か を指定す る値。 以下のいずれかの値を
指定 し ます。
• 0 （デフ ォ ル ト ） サーバへ接続す る と き にネ ッ ト ワ ー ク
ベー ス の ロ グ イ ン認証 を使用 し ま せん。 ま た、 'No' も
し く は 'False' を こ の値に指定す る こ と も で き ます。
• 1 サーバへ接続す る と き にネ ッ ト ワ ー ク ベー ス の ロ グ
イ ン認証を使用 し ます。 ア プ リ ケーシ ョ ン ではな く 、 セ
キ ュ リ テ ィ メ カ ニ ズ ム がユーザ名 （ ロ グ イ ン ID） を認
証 す る の で、 デ ー タ ベ ー ス
プ ロ フ ァ イル ま たは
PowerBuilder アプ リ ケーシ ョ ン ス ク リ プ ト で、認証のた
めに ロ グ イ ン パ ス ワ ー ド を入力す る 必要はあ り ません。
ま た、 'Yes' も し く は 'True' を こ の値に指定す る こ と
も で き ます。
デフ ォル ト 値
Sec_Network_Auth = 0
解説
設定が必要な場合 Sec_Network_Auth を 1 に設定 し て、 ネ ッ ト ワー ク
ベー ス の ロ グ イ ン 認証 を 有効 にす る こ と に は、 以下 に示す よ う に、
PowerBuilder ユーザに と っ て 3 つの大 き な利点があ り ま す。 こ れ ら の
利点はすべて、 Sec_Network_Auth が 1 に設定 さ れてい る と き には、 ロ
グ イ ン ID を 認証 す る た め に、 デー タ ベ ー ス プ ロ フ ァ イ ル ま た は
PowerBuilder ア プ リ ケーシ ョ ン ス ク リ プ ト で ロ グ イ ンパ ス ワ ー ド を入
力 し ないで済む こ と か ら く る も のです。
ロ グ イ ン パ ス
ワ ー ド を指定 し ないので、 ロ グ イ ン パ ス ワ ー ド は Windows レ ジ ス
ト リ に格納 さ れ ま せん。
•
パスワー ド がレ ジ ス ト リ フ ァ イ ルに格納 さ れません
•
パスワー ド がネ ッ ト ワー ク 上で転送 さ れません
•
さ まざま
な Adaptive Server デー タ ベース サーバに接続す る のに、 同 じ ネ ッ
ト ワ ー ク ユーザ ID お よ びパス ワ ー ド を使用で き ま す。ネ ッ ト ワ ー
ク セキ ュ リ テ ィ メ カ ニ ズ ム に合わせてパ ス ワー ド を変更 し 、 その
変更内容を、 ア プ リ ケーシ ョ ン が接続す る すべて のサーバに適用
で き ま す。
ロ グ イ ン パス ワー ド
を指定 し ないので、 ロ グ イ ン パ ス ワ ー ド がネ ッ ト ワー ク を介 し て
Adaptive Server に転送 さ れ る こ と は あ り ま せん。
異な るサーバで同 じ ユーザ ID と パスワー ド を使用で き ます
Release DBParm の設定 Sec_Network_Auth を有効にす る には、 Release
DBParm パ ラ メ ー タ に '11'、 '11.5'、 '12'、 '12.5' のいずれか を設定 し て、
ア プ リ ケ ー シ ョ ン が 適切 な バ ー ジ ョ ン の Sybase Open Client ClientLibrary （CT-Lib） の動作を使用す る こ と を指定す る 必要があ り ま す。
168
PowerBuilder
第1章
DBParm パ ラ メ ー タ
使用のための要件 Sec_Network_Auth ま た は、 Open Client セ キ ュ リ
テ ィ サービ ス を サポー ト し てい る ほかの DBParm パ ラ メ ー タ を使用す
る には、 PowerBuilder ア プ リ ケーシ ョ ン でセ キ ュ リ テ ィ サービ ス を使
用す る ための一定の要件を満た し てい る 必要が あ り ま す。 詳細につい
ては、 『デー タ ベー ス と の接続』 マニ ュ アル を参照 し て く だ さ い。
対応す る CT-Lib 接続プ ロ パテ ィ Sec_Network_Auth に値 を 指定す る
と 、 CS_SEC_NETWORKAUTH と い う 名前の、 対応す る Sybase CT-Lib
接続プ ロ パテ ィ が設定 さ れ ま す。
例
サーバに接続す る と き に、 使用 し てい る 接続がネ ッ ト ワ ー ク ベー ス の
ロ グ イ ン認証を使用す る こ と を指定す る には、 以下の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［セ キ ュ リ テ ィ ］ タ ブの ［ネ ッ ト ワ ー ク ベース 認証］ チ ェ ッ
ク ボ ッ ク ス を オ ンに し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に以下を入力 し ま す。
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 デー タ ベー ス に ア ク セ ス す る と き の、
ネ ッ ト ワ ー ク ベー ス の セ キ ュ リ テ ィ サー ビ ス の パ ケ ッ ト 単位の セ
キ ュ リ テ ィ を サポー ト す る DBParm パ ラ メ ー タ の う ちの 1 つです。 ほ
かのパケ ッ ト 単位のセ キ ュ リ テ ィ DBParm パ ラ メ ー タ については、「関
連項目」 を参照 し て く だ さ い。
169
Sec_Replay_Detection
Sec_Replay_Detection は、使用 し てい る 接続のセ キ ュ リ テ ィ メ カ ニズ ム
が転送デー タ に対す る 権限のないキ ャ プチ ャ お よ び リ プ レ イ の試みを
検出 し 拒絶で き る か ど う か を指定す る 値。Sec_Replay_Detection が 1 に
設定 さ れてい る 場合、 セキ ュ リ テ ィ メ カ ニ ズ ムは、 権限のない第 3 者
がサーバに送信 さ れたパケ ッ ト に対 し て行 う 、 キ ャ プチ ャ お よ びその
後のパケ ッ ト 内の コ マ ン ド の繰 り 返 し （ リ プ レ イ ） の試みを検出 し て
拒絶 し ま す。
Sec_Replay_Detection が 0 （デフ ォ ル ト ） に設定 さ れてい る 場合、セ キ ュ
リ テ ィ メ カ ニ ズ ム は、 デー タ に対す る 権限のないキ ャ プチ ャ や リ プ レ
イ の試みを検出で き ま せん。
Sec_Replay_Detection DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ
ベース に接続す る 前に指定 し ま す。
サー ド パーテ ィ のセキ ュ リ テ ィ メ カ ニズムの使用
Sybase が Open Client セ キ ュ リ テ ィ サー ビ ス で テ ス ト 済みの サー ド
パーテ ィ のセ キ ュ リ テ ィ メ カ ニ ズ ムお よ びオペ レ ーテ ィ ン グ シ ス テ
ム プ ラ ッ ト フ ォーム の詳細については、 Open Client の ド キ ュ メ ン ト を
参照 し て く だ さ い。
対象
SYC Sybase Adaptive Server Enterprise
構文
Sec_Replay_Detection = value
パラ メ ー タ
value
デフ ォル ト 値
170
説明
使用 し てい る 接続のセ キ ュ リ テ ィ メ カ ニ ズ ム が転送
デー タ に対す る 権限の ない キ ャ プ チ ャ お よ び リ プ レ
イ の試み を検出 し 拒絶で き る か ど う か を指定す る 値。
以下のいずれかの値を指定 し ます。
• 0 （デ フ ォ ル ト ） 使用 し て い る セ キ ュ リ テ ィ メ カ
ニ ズ ム は、 転送デー タ に対す る 権限の な い キ ャ プ
チ ャ お よ び リ プ レ イ の試み を 検出で き ま せん。 ま
た、 'No' も し く は 'False' を こ の値に指定す る こ
と も で き ま す。
• 1 使用 し てい る セ キ ュ リ テ ィ メ カ ニ ズ ムは、 転送
デー タ に対す る 権限の ない キ ャ プチ ャ お よ び リ プ
レ イ の試みを検出 し 拒絶で き ます。 ま た、 'Yes' も
し く は 'True' を こ の 値に指定す る こ と も で き ま
す。
Sec_Replay_Detection = 0
PowerBuilder
第1章
解説
DBParm パ ラ メ ー タ
設定が必要な場合 セ キ ュ リ テ ィ が設定 さ れていないネ ッ ト ワ ー ク で
は、 権限のない第三者が、 サーバに送信 さ れた コ マ ン ド を キ ャ プチ ャ
し て、 後日、 そ の コ マ ン ド を繰 り 返す （ リ プ レ イ す る ） こ と も 起 こ り
得 ま す。 た と え ば、 ク ラ イ ア ン ト か ら サーバに P1、 P2、 P3 の順で送
信 さ れたパケ ッ ト を、 サーバが P1、 P2、 P2 の順で受け取っ た場合は、
デ ー タ の リ プ レ イ が 試 み ら れ て い る と 考 え ら れ ま す。
Sec_Replay_Detection を 1 に設定す る と 、 その よ う な、 ネ ッ ト ワー ク 上
で転送 さ れ る デー タ に対す る 権限のないキ ャ プチ ャ お よ び リ プ レ イ の
試みがセ キ ュ リ テ ィ メ カ ニズ ム に よ っ て検出 さ れ、 拒絶 さ れ る こ と が
保証 さ れ ま す。
Release DBParm の設定 Sec_Replay_Detection を有効にす る には、
Release DBParm パ ラ メ ー タ に '11'、 '11.5'、 '12'、 '12.5' のいずれか を設
定 し て、 アプ リ ケーシ ョ ン が適切なバージ ョ ン の Sybase Open Client
Client-Library （CT-Lib） の動作を使用す る こ と を指定す る 必要があ り
ま す。
使用のための要件 Sec_Replay_Detection ま たは、Open Client セ キ ュ リ
テ ィ サービ ス を サポー ト し てい る ほかの DBParm パ ラ メ ー タ を使用す
る には、 PowerBuilder ア プ リ ケーシ ョ ン でセ キ ュ リ テ ィ サービ ス を使
用す る ための一定の要件を満た し てい る 必要が あ り ま す。 詳細につい
ては、 『デー タ ベー ス と の接続』 マニ ュ アル を参照 し て く だ さ い。
対応す る CT-Lib 接続プ ロ パテ ィ Sec_Replay_Detection に値 を 指定す
る と 、 CS_SEC_DETECTREPLAY と い う 名前の、 対応す る Sybase CTLib 接続プ ロ パテ ィ が設定 さ れ ま す。
例
セ キ ュ リ テ ィ メ カ ニ ズ ム が、 転送デー タ に対す る 権限の な い キ ャ プ
チ ャ お よ び リ プ レ イ の試みを検出 し 、 拒絶で き る よ う にす る には、 以
下の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［セ キ ュ リ テ ィ ］ タ ブの ［再生 さ れた コ マ ン ド の検出］ チ ェ ッ
ク ボ ッ ク ス を オ ンに し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に以下を入力 し ま す。
SQLCA.DBParm = "Sec_Replay_Detection = 1; Release =
12.5"
関連項目
接続 リ フ ァ レ ン ス
Release
Sec_Confidential
Sec_Data_Integrity
Sec_Data_Origin
Sec_Seq_Detection
171
Sec_Seq_Detection
Sec_Seq_Detection
機能
Sec_Seq_Detection は、 PowerBuilder か ら Open Client を経由 し て Sybase
Adaptive Server Enterprise デー タ ベース にア ク セ ス す る と き の、 ネ ッ ト
ワ ー ク ベー ス の セ キ ュ リ テ ィ サー ビ ス のパ ケ ッ ト 単位の セ キ ュ リ
テ ィ を サポー ト す る DBParm パ ラ メ ー タ の う ちの 1 つです。 ほかのパ
ケ ッ ト 単位の セ キ ュ リ テ ィ DBParm パ ラ メ ー タ につい ては、 「関連項
目」 を参照 し て く だ さ い。
Sec_Seq_Detection は、 使用 し て い る 接続の セ キ ュ リ テ ィ メ カ ニ ズ ム
が、 ク ラ イ ア ン ト か ら 最初に送信 さ れたの と は異な る 順序でサーバに
届いた転送パケ ッ ト を検出お よ び拒絶で き る か ど う か を 制御 し ま す。
Sec_Seq_Detection が 1 に設定 さ れてい る 場合、 セ キ ュ リ テ ィ メ カ ニ ズ
ム は、誤っ た順序でサーバに届いたパケ ッ ト を検出お よ び拒絶 し ま す。
Sec_Seq_Detection が 0 （デ フ ォ ル ト ） に設定 さ れて い る 場合、 セ キ ュ
リ テ ィ メ カ ニ ズ ム は、 誤っ た順序でサーバに届いたパケ ッ ト を検出で
き ま せん。
Sec_Seq_Detection DBParm パ ラ メ ー タ は、PowerBuilder か ら デー タ ベー
ス に接続す る 前に指定 し ま す。
サー ド パーテ ィ のセキ ュ リ テ ィ メ カ ニズムの使用
Sybase が Open Client セ キ ュ リ テ ィ サー ビ ス で テ ス ト 済みの サー ド
パーテ ィ のセ キ ュ リ テ ィ メ カ ニ ズ ムお よ びオペ レ ーテ ィ ン グ シ ス テ
ム プ ラ ッ ト フ ォーム の詳細については、 Open Client の ド キ ュ メ ン ト を
参照 し て く だ さ い。
対象
SYC Sybase Adaptive Server Enterprise
構文
Sec_Seq_Detection = value
172
PowerBuilder
第1章
パラ メ ー タ
value
DBParm パ ラ メ ー タ
説明
使用 し てい る 接続のセキ ュ リ テ ィ メ カニ ズ ム が、ク ラ
イ ア ン ト か ら 最初に送信 さ れた の と は異な る 順序で
サーバに届い た転送パ ケ ッ ト を 検出お よ び拒絶で き
る か ど う か を指定す る 値。 以下のいずれかの値 を指定
し ます。
• 0 （デ フ ォ ル ト ） セキ ュ リ テ ィ メ カ ニズ ム は、誤 っ
た順序でサーバに届い た パ ケ ッ ト を 検出で き ま せ
ん。 ま た、 'No' も し く は 'False' を こ の値に指定
す る こ と も で き ます。
• 1 セキ ュ リ テ ィ メ カ ニズ ムは、 誤 っ た順序でサー
バ に 届い た パ ケ ッ ト を 検出お よ び拒絶 で き ま す。
ま た、 'Yes' も し く は 'True' を こ の値に指定す る
こ と も で き ます。
デ フ ォル ト 値
Sec_Seq_Detection = 0
解説
設定が必要な場合 ネ ッ ト ワ ー ク 上でデー タ を転送す る と き 、 サーバ
に送信 さ れた コ マ ン ド が誤っ た順序で届 く こ と があ り ま す。た と えば、
ク ラ イ ア ン ト か ら サーバに P1、 P2、 P3 の順で送信 さ れたパケ ッ ト を、
サーバが P1、 P3、 P2 の順で受け取っ た場合、 順序の誤 り のエ ラ ーが
発生 し た と 考え ら れ ま す。
Sec_Seq_Detection を 1 に設定す る と 、 誤っ た順序でサーバに届いたパ
ケ ッ ト がセ キ ュ リ テ ィ メ カ ニ ズ ム に よ り 検出お よ び拒絶 さ れ る こ と
が保証 さ れ ま す。
Release DBParm の設定 Sec_Seq_Detection を有効にす る には、 Release
DBParm パ ラ メ ー タ に '11'、 '11.5'、 '12'、 '12.5' のいずれか を 設定 し て、
ア プ リ ケ ー シ ョ ン が 適 切 な バ ー ジ ョ ン の Sybase Open Client ClientLibrary （CT-Lib） の動作を使用す る こ と を指定す る 必要があ り ま す。
使用のための要件 Sec_Seq_Detection ま た は、 Open Client セ キ ュ リ
テ ィ サービ ス を サポー ト し てい る ほかの DBParm パ ラ メ ー タ を使用す
る には、 PowerBuilder ア プ リ ケーシ ョ ン でセ キ ュ リ テ ィ サービ ス を使
用す る ための一定の要件を満た し てい る 必要が あ り ま す。 詳細につい
ては、 『デー タ ベー ス と の接続』 マニ ュ アル を参照 し て く だ さ い。
対応す る CT-Lib 接続プ ロ パテ ィ Sec_Seq_Detection に 値 を 指定す る
と 、 CS_SEC_DETECTSEQ と い う 名前の、 対応す る Sybase CT-Lib 接続
プ ロ パテ ィ が設定 さ れ ま す。
例
接続 リ フ ァ レ ン ス
セ キ ュ リ テ ィ メ カ ニズ ム が、 誤っ た順序でサーバに届いたパケ ッ ト を
検出お よ び拒絶で き る よ う にす る には、 以下の よ う に し ま す。
173
Sec_Server_Principal
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［セ キ ュ リ テ ィ ］ タ ブの ［シーケ ン ス エ ラ ーの検出］ チ ェ ッ
ク ボ ッ ク ス をオ ン に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に以下を入力 し ま す。
SQLCA.DBParm = "Sec_Seq_Detection = 1; Release = 12"
関連項目
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 デー タ ベー ス に ア ク セ ス す る と き の、
ネ ッ ト ワ ー ク ベー ス の セ キ ュ リ テ ィ サー ビ ス の ロ グ イ ン 認証 を サ
ポー ト す る DBParm パ ラ メ ー タ の う ちの 1 つです。 ほかの ロ グ イ ン認
証 DBParm パ ラ メ ー タ については、 「関連項目」 を参照 し て く だ さ い。
Sec_Server_Principal は、 ア ク セ ス す る サーバのプ リ ン シプル名を指定
し ま す。 サーバ プ リ ン シプル名は、 セキ ュ リ テ ィ メ カ ニ ズ ム がそれぞ
れのサーバ を識別す る のに使 う 名前です。
サーバ名 （デー タ ベー ス プ ロ フ ァ イ ルま たは PowerBuilder アプ リ ケー
シ ョ ン ス ク リ プ ト で指定） が、 ア ク セ ス す る サーバのサーバ プ リ ン シ
プル名 と は異な る 場合、 接続す る ためには、 Sec_Server_Principal を適
切なサーバ プ リ ン シプル名に設定す る 必要があ り ま す。
Sec_Server_Principal DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ
ベース に接続す る 前に指定 し ま す。
サー ド パーテ ィ のセキ ュ リ テ ィ メ カ ニズムの使用
Sybase が Open Client セ キ ュ リ テ ィ サー ビ ス で テ ス ト 済みの サー ド
パーテ ィ のセ キ ュ リ テ ィ メ カ ニ ズ ムお よ びオペ レ ーテ ィ ン グ シ ス テ
ム プ ラ ッ ト フ ォーム の詳細については、 Open Client の ド キ ュ メ ン ト を
参照 し て く だ さ い。
対象
SYC Sybase Adaptive Server Enterprise
構文
Sec_Server_Principal = 'server_principal_name'
174
PowerBuilder
第1章
パラ メ ー タ
server_principal_name
デ フ ォル ト 値
DBParm パ ラ メ ー タ
説明
ア ク セ スす る サーバ プ リ ン シプル名。
なし
値を指定 し ない場合、 セ キ ュ リ テ ィ メ カ ニ ズ ムは、 サーバのデ ィ レ ク
ト リ エ ン ト リ 名を使用 し ま す。 こ れはデー タ ベース プ ロ フ ァ イ ルま た
は PowerBuilder ア プ リ ケーシ ョ ン ス ク リ プ ト で指定 さ れ る サーバ名 と
同 じ です。
解説
設定が必要な場合 PowerBuilder で Open Client セキ ュ リ テ ィ メ カ ニ ズ
ム を使用 し てい る と き は、 サーバのデ ィ レ ク ト リ エ ン ト リ 名 （デー タ
ベー ス プ ロ フ ァ イ ル ま たは PowerBuilder ア プ リ ケーシ ョ ン ス ク リ プ
ト でサーバ名 と し て指定 し た名前） は、 サーバ プ リ ン シプル名 と 異な
り ま す。 こ の場合は、 ア ク セ ス す る サーバを セ キ ュ リ テ ィ メ カ ニ ズ ム
が識別で き る よ う に、 Sec_Server_Principal を適切なサーバ プ リ ン シプ
ル名に設定す る 必要があ り ま す。
Release DBParm の設定 Sec_Server_Principal を有効にす る には、
Release DBParm パ ラ メ ー タ に '11'、 '11.5'、 '12'、 '12.5' のいずれか を設
定 し て、 アプ リ ケーシ ョ ン が適切なバージ ョ ン の Sybase Open Client
Client-Library （CT-Lib） の動作を使用す る こ と を指定す る 必要があ り
ま す。
使用のための要件 Sec_Server_Principal ま たは、 Open Client セ キ ュ リ
テ ィ サービ ス を サポー ト し てい る ほかの DBParm パ ラ メ ー タ を使用す
る には、 PowerBuilder ア プ リ ケーシ ョ ン でセ キ ュ リ テ ィ サービ ス を使
用す る ための一定の要件を満た し てい る 必要が あ り ま す。 詳細につい
ては、 『デー タ ベー ス と の接続』 マニ ュ アル を参照 し て く だ さ い。
対応す る CT-Lib 接続プ ロ パテ ィ Sec_Server_Principal に 値 を 指 定 す
る と 、CS_SEC_SERVERPRINCIPAL と い う 名前の、対応す る Sybase CTLib 接続プ ロ パテ ィ が設定 さ れ ま す。
例
ア ク セ ス す る サーバのプ リ ン シプル名 と し て SYS12NT を 指定す る に
は、 以下の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［セキ ュ リ テ ィ ］ タ ブの ［サーバの主名］ ボ ッ ク ス に SYS12NT
と 入力 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に以下を入力 し ま す。
SQLCA.DBParm = "Sec_Server_Principal = 'SYS12NT';
Release = 12"
接続 リ フ ァ レ ン ス
175
Sec_Sess_Timeout
関連項目
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 デー タ ベース にア ク セ ス す る と き の、 ネ ッ ト
ワ ー ク ベー ス のセ キ ュ リ テ ィ サー ビ ス の ロ グ イ ン 認証 を サポー ト す
る DBParm パ ラ メ ー タ の う ちの 1 つです。 ほかの ロ グ イ ン認証 DBParm
パ ラ メ ー タ については、 「関連項目」 を参照 し て く だ さ い。
一部の セ キ ュ リ テ ィ メ カ ニ ズ ム では、 ア プ リ ケ ーシ ョ ン で、 ネ ッ ト
ワ ー ク ベー ス の ロ グ イ ン 認証 を使 っ た接続にセ ッ シ ョ ン タ イ ム ア ウ
ト 値を設定で き ま す。Sec_Sess_Timeout は、 こ の よ う な接続でセ ッ シ ョ
ン が期限切れにな る ま での残 り の秒数を指定 し ま す。 セ ッ シ ョ ン タ イ
ム ア ウ ト は、接続がオープ ン さ れた時点か ら カ ウ ン ト が開始 さ れ ま す。
デフ ォ ル ト では、 Sec_Sess_Timeout にセ ッ シ ョ ン タ イ ム ア ウ ト が指定
さ れ ま せん。 そのため、 セ ッ シ ョ ン の タ イ ム ア ウ ト は設定 さ れ ま せん。
Sec_Sess_Timeout DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー
ス に接続す る 前に指定 し ま す。
サー ド パーテ ィ のセキ ュ リ テ ィ メ カ ニズムの使用
Sybase が Open Client セ キ ュ リ テ ィ サー ビ ス で テ ス ト 済みの サー ド
パーテ ィ のセ キ ュ リ テ ィ メ カ ニ ズ ムお よ びオペ レ ーテ ィ ン グ シ ス テ
ム プ ラ ッ ト フ ォーム の詳細については、 Open Client の ド キ ュ メ ン ト を
参照 し て く だ さ い。
対象
SYC Sybase Adaptive Server Enterprise
構文
Sec_Sess_Timeout = value
176
PowerBuilder
第1章
パラ メ ー タ
value
DBParm パ ラ メ ー タ
説明
セ ッ シ ョ ン が 期 限 切 れ に な る ま で の 残 り の 秒 数。
'no_limit' （デ フ ォ ル ト ） を指定 し て、 セ ッ シ ョ ン に タ イ
ム ア ウ ト が設定 さ れない よ う にす る こ と も で き ま す。
セ キ ュ リ テ ィ シ ス テ ム の管理者に よ っ て 設定 さ れた セ ッ
シ ョ ン タ イ ム ア ウ ト 値は、 Sec_Sess_Timeout に優先 し て指
定 さ れま す。
デ フ ォル ト 値
Sec_Sess_Timeout = 'no_limit'
解説
CyberSafe Kerberos の場合 使用 し て い る セ キ ュ リ テ ィ メ カ ニ ズ ム が
CyberSafe Kerberos の場合、 Sec_Sess_Timeout は、 イ ン ス ト ール時のデ
フ ォ ル ト のセ ッ シ ョ ン タ イ ム ア ウ ト 値を上書 き で き ま せん。
Release DBParm の設定 Sec_Sess_Timeout を有効にす る には、 Release
DBParm パ ラ メ ー タ に '11'、 '11.5'、 '12'、 '12.5' のいずれか を 設定 し て、
ア プ リ ケ ー シ ョ ン が 適 切 な バ ー ジ ョ ン の Sybase Open Client ClientLibrary （CT-Lib） の動作を使用す る こ と を指定す る 必要があ り ま す。
使用のための要件 Sec_Sess_Timeout ま た は、 Open Client セ キ ュ リ
テ ィ サービ ス を サポー ト し てい る ほかの DBParm パ ラ メ ー タ を使用す
る には、 PowerBuilder ア プ リ ケーシ ョ ン でセ キ ュ リ テ ィ サービ ス を使
用す る ための一定の要件を満た し てい る 必要が あ り ま す。 詳細につい
ては、 『デー タ ベー ス と の接続』 マニ ュ アル を参照 し て く だ さ い。
対応す る CT-Lib 接続プ ロ パテ ィ Sec_Sess_Timeout に 値 を 指 定 す る
と 、 CS_SEC_SESSTIMEOUT と い う 名前の、 対応す る Sybase CT-Lib 接
続プ ロ パテ ィ が設定 さ れ ま す。
例
セ ッ シ ョ ンが 14,400 秒 （4 時間） 後に タ イ ム ア ウ ト にな る よ う に指定
す る には、 次の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［セ キ ュ リ テ ィ ］ タ ブの ［セ ッ シ ョ ン タ イ ム ア ウ ト ］ ボ ッ
ク ス に 14400 と 入力 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に以下を入力 し ま す。
SQLCA.DBParm = "Sec_Sess_Timeout = 14400"
関連項目
接続 リ フ ァ レ ン ス
Release
Sec_Channel_Bind
Sec_Cred_Timeout
Sec_Delegation
Sec_Keytab_File
Sec_Mechanism
177
Secure
Sec_Mutual_Auth
Sec_Network_Auth
Sec_Server_Principal
Secure
機能
PowerBuilder か ら Microsoft SQL Server デー タ ベース サーバに接続す る
と き に、 Windows NT 統合 ロ グ イ ン セ キ ュ リ テ ィ や信頼性のあ る 接続
を使用す る か ど う か を指定す る 値。
デフ ォ ル ト では、 デー タ ベース にア ク セ ス す る と き に、 SQL Server 標
準セキ ュ リ テ ィ や信頼性のない接続が使用 さ れ ま す。 Secure パ ラ メ ー
タ に 1 を設定す る と 、 サーバ上で現在使用 さ れてい る ロ グ イ ン セ キ ュ
リ テ ィ と は無関係に、 標準セキ ュ リ テ ィ に代わっ て Windows NT 統合
セ キ ュ リ テ ィ を 使用 し て、 接続 さ れ ま す。 信頼性の あ る 接続の場合、
指定す る ロ グ イ ン ID やパ ス ワ ー ド は無視 さ れ ま す。
対象
MSS Microsoft SQL Server
構文
Secure = value
パラ メ ー タ
value
説明
PowerBuilder か ら Microsoft SQL Server に 接続す る と き に、
Windows NT 統合 ロ グ イ ン セ キ ュ リ テ ィ や信頼性の あ る 接
続を使用す る か ど う か を指定す る 値。以下のいずれかの値 を
指定 し ま す。
• 0 （デ フ ォ ル ト ） SQL Server 標準 の ロ グ イ ン セ キ ュ リ
テ ィ や信頼性のない接続 を使用 し ま す。 ま た、 'No' も し
く は 'False' を こ の値に指定す る こ と も で き ます。
• 1 Windows NT 統合 ロ グ イ ン セキ ュ リ テ ィ や信頼性の あ
る 接続を使用 し ま す。 ただ し 、こ の機能がサ イ ト で設定 さ
れてい る 必要が あ り ます。 ま た、 'Yes' も し く は 'True'
を こ の値に指定す る こ と も で き ます。
デフ ォル ト 値
Secure = 0
解説
Microsoft SQL Server のセ キ ュ リ テ ィ について Secure DBParm パ ラ
メ ー タ を 効果的に使用す る た め には、 Microsoft SQL Server セ キ ュ リ
テ ィ メ カ ニ ズ ム を理解 し てお く と 役に立ち ま す。 SQL Server は、 3 種
類のサーバ ロ グ イ ン セ キ ュ リ テ ィ モー ド を備え てい ま す。
178
PowerBuilder
第1章
DBParm パ ラ メ ー タ
Windows NT 認証 メ カ ニ ズ ム を使用 し て、すべて
の接続について SQL Server ロ グ イ ン の有効性を検証 し ま す。 こ れ
に よ っ て、 必要な特権を持つネ ッ ト ワー ク ユーザは、 ロ グ イ ン ID
やパ ス ワ ー ド を個別に指定 し な く て も 、 SQL Server に ロ グ イ ン で
き ま す。 統合セ キ ュ リ テ ィ は、 ク ラ イ ア ン ト と サーバ と の間の認
証接続を サポー ト す る ネ ッ ト ワー ク プ ロ ト コ ル上で、 信頼性のあ
る 接続を使用す る こ と を要求 し ま す。
•
統合セキ ュ リ テ ィ
•
標準セキ ュ リ テ ィ
•
混合セキ ュ リ テ ィ
すべての接続について、 SQL Server ロ グ イ ン検
証 メ カ ニ ズ ム を使用 し ま す。 標準セ キ ュ リ テ ィ は、 信頼性の ない
接続を使用 し ま す。
統合セ キ ュ リ テ ィ と 標準セ キ ュ リ テ ィ を組み合
わせて、 ロ グ イ ン リ ク エ ス ト の有効性を検証 し ま す。
Secure パ ラ メ ー タ を使用す る ための要件 PowerBuilder において
Secure DBParm パ ラ メ ー タ が有効で あ る ためには、 最初に、 開発者ま
たはデー タ ベース 管理者が、 SQL Server 管理者 ま たはユーザの特権
を、 適切な Windows NT グループ ま たはユーザに与え て、 信頼性のあ
る 接続を使用で き る よ う に し ま す。
統合 ロ グ イ ン セ キ ュ リ テ ィ や信頼性の あ る 接続 を サ イ ト で設定す る
手順については、 Microsoft SQL Server のマニ ュ アルを参照 し て く だ さ
い。
例
PowerBuilder か ら Microsoft SQL Server に接続す る と き に、Windows NT
統合 ロ グ イ ン セ キ ュ リ テ ィ や信頼性の あ る 接続 を 使用す る こ と を 指
定す る には以下の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ネ ッ ト ワ ー ク ］ タ ブの ［統合セキ ュ リ テ ィ ］ チ ェ ッ ク ボ ッ
ク ス を オ ンに し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で、 以下の入力を行い ま す。
アプ リ
SQLCA.dbParm = "Secure = 1"
ServiceComponents
機能
接続 リ フ ァ レ ン ス
OLE DB イ ン タ フ ェー ス が使用で き る グ ロ ーバル サービ ス を指定 し ま
す。
179
SQLCache
ServiceComponents を指定する タ イ ミ ン グ
ServiceComponents DBParm パ ラ メ ー タ は、 PowerBuilder か ら デ ー タ
ベース に接続す る 前に指定 し ま す。
対象
OLE DB
構文
ServiceComponents = 'servicecomponent_name'
デフ ォル ト 値
なし
例
リ ソ ー ス プー リ ン グ サービ ス コ ン ポーネ ン ト を有効にす る には以下
の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［シ ス テ ム］ タ ブの ［サー ビ ス コ ン ポーネ ン ト サポー ト ］
ボ ッ ク ス か ら 「 リ ソ ー ス プー リ ン グ」 を選択 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で以下の入力を行い ま す。
アプ リ
SQLCA.dbParm = "ServiceComponents =
'DBPROPVAL_OS_RESOURCEPOOLING'"
SQLCache
機能
PowerBuilder がキ ャ ッ シ ュ す る SQL 文の個数を指定 し ま す。 デフ ォ ル
ト 値は 0 で、 SQL キ ャ ッ シ ュ は空にな り ま す。
PowerBuilder では、 以下を対象に し た キ ャ ッ シ ュ 処理が行われ ま す。
•
デー タ ウ ィ ン ド ウ オブジ ェ ク ト が作成す る SQL 文
•
埋め込み SQL 文
対象
ODBC
O73 Oracle 7.3
構文
SQLCache パ ラ メ ー タ を 指定す る 構文は、 使用 し て い る デー タ ベー ス
イ ン タ フ ェ ース に よ っ て異な り ま す。
ODBC の構文 ODBC イ ン タ フ ェ ー ス を使用 し てい る 場合、 SQLCache
パ ラ メ ー タ を指定す る には、 以下の構文を使用 し ま す。
SQLCache = value
180
PowerBuilder
第1章
パラ メ ー タ
value
DBParm パ ラ メ ー タ
説明
ス ク リ プ ト で開 く カー ソ ルの個数に、 デー タ ウ ィ ン ド ウ に
よ っ て作成 さ れ る 、 検索引数を伴 う SELECT 文の個数を加
え た数値。 デフ ォ ル ト 値は 0 です。
Oracle 構文 Oracle 7.x デー タ ベー ス に対 し て SQLCache パ ラ メ ー タ を
指定す る には、 以下の構文を使用 し ま す。
SQLCache = value
value には、 ク ラ イ ア ン ト マ シ ン で開 く こ と ので き る カー ソ ルの最大
数 よ り も 小 さ い数値を指定 し ま す。 こ の数値を決定す る には、 以下の
式を使用 し ま す。
value < = open_cursors–reserved–declare_cursor_space
Oracle 8.x 以降では、 Oracle OCI が キ ャ ッ シ ュ を 処理す る ので、
SQLCache を設定す る こ と をお勧め し ま せん。
注意
パラ メ ー タ
open_cursors
説明
1 つのプ ロ セ ス が一度に開 く こ と ので き る カー ソ ル
の最大数を指定す る 、 Oracle サーバの設定
（OPEN_CURSORS 初期化パ ラ メ ー タ の値）。
Oracle 7.x デー タ ベー ス サーバ では、 open_cursors
は 1 か ら オペ レーテ ィ ン グ シ ス テ ム の最大数 ま で
（デ フ ォ ル ト ＝ 50）。
reserved
予約 さ れ た カ ー ソ ル の個数。 Oracle デー タ ベー ス
イ ン タ フ ェ ー ス の い ずれに対 し て も カ ー ソ ル を 5
つ予約 し てお く 必要が あ り ます。
declare_cursor_space
Oracle デー タ ベー ス と の接続 ご と に開 く カ ー ソ ル
の最大数。
デ フ ォル ト 値
SQLCache = 0
解説
キ ャ ッ シ ュ の中での ス テー ト メ ン ト の管理 SQL キ ャ ッ シ ュ の中の ス
テー ト メ ン ト は、 LRU （least-recently-used） 法で管理 さ れてい ま す。 つ
ま り 、 キ ャ ッ シ ュ か ら ス テー ト メ ン ト を削除 し て、 新た な ス テー ト メ
ン ト 用の領域を確保す る 場合、 最 も 古 く に実行 さ れた ス テー ト メ ン ト
が削除 さ れ ま す。
接続 リ フ ァ レ ン ス
181
SQLCache
SQLCache と バ イ ン ド 変数 頻繁に実行す る SQL 文を キ ャ ッ シ ュ す る
と 、 その SQL 文の処理速度が向上 し ま す。 特に、 バ イ ン ド 変数が使用
さ れてい る SQL 文は、 ア プ リ ケーシ ョ ン の中で頻繁に使用 さ れ ま す。
なお、 使用 し てい る DBMS でバ イ ン ド 変数がサポー ト さ れていない場
合は、 SQL 文を キ ャ ッ シ ュ す る 意味は あ ま り あ り ま せん。
SQL 文を キ ャ ッ シ ュ す る 際の DisableBind の設定 SQL 文 を キ ャ ッ
シ ュ す る 際には、 DisableBind DBParm パ ラ メ ー タ を 0 （デフ ォ ル ト 設
定） に設定 し ま す。 こ の設定に よ っ て、 PowerBuilder の SQL 文で、 入
力変数をバ イ ン ド で き る よ う にな り ま す。
バ イ ン ド 変数については、 DisableBind を参照 し て く だ さ い。
設定後の処理 バ イ ン ド 変数 を 使用す る SQL 文 を 最初に実行す る 際
に、 PowerBuilder に よ っ て以下の順序で処理が さ れ ま す。
1
SQL 文を解析 し ま す。
2
SQL SELECT 文に対 し て適切なデー タ ベー ス 関数を呼び出 し 、 結
果集合の情報を取得 し ま す。
3
バ イ ン ド 変数に対 し て メ モ リ バ ッ フ ァ を割 り 当て ま す。
4
割 り 当て ら れた メ モ リ バ ッ フ ァ を解析 さ れた SQL 文にバ イ ン ド
し ま す。
SQL 文を キ ャ ッ シ ュ す る と 、 解析 さ れた SQL 文、 結果集合の情報、 メ
モ リ バ ッ フ ァ の割 り 当て と バ イ ン ド 情報が、 SQL キ ャ ッ シ ュ に格納 さ
れ ま す。 次回以降、 こ の SQL 文を実行す る と 、 PowerBuilder がキ ャ ッ
シ ュ か ら こ の SQL 文を見つけ る ので、 前述の処理を繰 り 返す必要があ
り ま せん。
PowerBuilder に よ っ て SQL キ ャ ッ シ ュ 内で完全に合致す る SQL 文が
検出 さ れた場合は、 バ イ ン ド 変数にバ イ ン ド さ れ る 新 し い値が、 あ ら
か じ め割 り 当て ら れた メ モ リ バ ッ フ ァ に コ ピ ー さ れ、 SQL 文が直ちに
実行 さ れ ま す。 こ の方式は、 SQL 文のバ イ ン ド 変数を一か ら 処理す る
場合に比べて、 格段に速い処理が期待で き ま す。
SQL キ ャ ッ シ ュ のサ イ ズの決定 適切 な SQL キ ャ ッ シ ュ の サ イ ズ を
決定す る には、 ト ラ ンザ ク シ ョ ン オブ ジ ェ ク ト の SQLReturnData プ ロ
パテ ィ の値をチ ェ ッ ク し ま す。
デー タ ベース と の接続を解除す る と 、 以下に示す よ う に、 SQL キ ャ ッ
シ ュ の ヒ ッ ト の数、 ミ ス の数、 エ ン ト リ の数が、 SQLReturnData プ ロ
パテ ィ に格納 さ れ ま す。
•
182
ヒ ッ ト SQL キ ャ ッ シ ュ の中で、 合致す る SQL 文が検出 さ れた回
数です。
PowerBuilder
第1章
例
DBParm パ ラ メ ー タ
•
ミ ス SQL キ ャ ッ シ ュ の中で、 合致す る SQL 文を検出で き なか っ
た回数です。
•
エ ン ト リ SQL キ ャ ッ シ ュ の中の SQL 文の総数で す。 こ の値は、
SQLCache パ ラ メ ー タ の設定に よ っ て決定 さ れ ます。
SQL 文を 25 個キ ャ ッ シ ュ で き る だけの SQL キ ャ ッ シ ュ サ イ ズ を設定
す る には以下の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ ト ラ ン ザ ク シ ョ ン］ タ ブ の ［キ ャ ッ シ ュ を 行 う SQL ス
テー ト メ ン ト 数］ ボ ッ ク ス に 25 と 入力 し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で以下の入力を行い ま す。
アプ リ
SQLCA.dbParm = "SQLCache = 25"
関連項目
DisableBind
StaticBind
機能
デー タ ベー ス か ら デー タ ウ ィ ン ド ウ オ ブ ジ ェ ク ト ま た は レ ポー ト に
デー タ を取得す る と き 、 PowerBuilder では、 デー タ を取得す る 前に、 結
果集合の情報を入手 し た上でデー タ ベー ス に対 し て SELECT 文が有効
か ど う か検証 さ れ ま せん。 こ の結果、 特に ネ ッ ト ワ ー ク 上のデー タ
ベー ス にア ク セ ス す る と き 、 デー タ 取得が よ り 高速にな り ま す （ こ の
機能は describeless retrieval と も 呼ばれ ま す）。
デフ ォ ル ト 処理を変更 し 、 PowerBuilder でデー タ を取得す る 前に結果
集合の情報 を 入手す る よ う に設定す る には、 StaticBind DBParm パ ラ
メ ー タ を 0 ま たは No に設定 し ま す。
対象
JDB JDBC
MSS Microsoft SQL Server
ODBC
OLE DB
O73 Oracle 7.3
O84 Oracle 8.x お よ び Oracle8i
O90 Oracle9i
SYC お よ び SYJ Sybase Adaptive Server Enterprise
構文
StaticBind = value
接続 リ フ ァ レ ン ス
183
StaticBind
パラ メ ー タ
value
説明
デー タ ベー ス か ら デー タ ウ ィ ン ド ウ オ ブ ジ ェ ク ト ま たは
レ ポー ト にデー タ を取得す る 前に、 PowerBuilder が結果集
合の情報を入手す る か ど う か を指定す る値。 以下のいずれ
かの値 を指定 し ます。
• 0 デー タ を 取得す る 前 に 結果 集合 の 情報 を 入手 し ま
す。 'No' と 指定 し て、 こ の値 を 設定す る こ と も で き ま
す。
• 1 （デフ ォ ル ト ） デー タ を取得す る前に、 結果集合の情
報 を入手 し ません。 'Yes' と 指定 し て、 こ の値を設定す
る こ と も で き ます。
デフ ォル ト 値
StaticBind = 1
解説
有効性の検証 StaticBind パ ラ メ ー タ が 1 （デフ ォ ル ト ） に設定 さ れ る
と 、 PowerBuilder では、 デー タ を取得す る 前に、 デー タ ベー ス に対 し
て SELECT 文が有効で あ る か ど う か を検証 し ま せん。 こ の場合、 結果
集合 と 、 結果集合が取得 さ れ る デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト ま たは
レ ポー ト のカ ラ ム書式が一致す る も の と 見な さ れ ま す。 両者が一致 し
ない場合は、 エ ラ ーが表示 さ れ ま す。
ト ラ ブルシ ュ ーテ ィ ン グ の ヒ ン ト デー タ ウ ィ ン ド ウ オ ブ ジ ェ ク ト
ま たは レ ポー ト が入手す る 結果集合の情報 と 、 現行のデー タ ベー ス に
おけ る 結果集合の情報が異な る 場合、 ア プ リ ケーシ ョ ン の中で問題が
発生す る 可能性があ り ま す。 こ の状態は、 以下の原因で発生 し ま す。
•
デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト ま たは レ ポー ト を作成 し た後で、
デー タ ベース の定義が変更 さ れた場合。
•
あ る DBMS に接続 し てい る 状態でデー タ ウ ィ ン ド ウ オブ ジ ェ ク
ト ま たは レ ポー ト を作成 し 、 別の DBMS に対 し て こ れを実行 し た
場合。
結果集合情報が矛盾す る ために発生す る 問題を解決す る には、 以下の
いずれか の方法でデー タ ウ ィ ン ド ウ オブ ジ ェ ク ト ま たは レ ポー ト 定
義を訂正 し ま す。
184
•
カ ラ ム定義をエ ク ス ポー ト し 、 編集 し ま す。
•
デー タ ベース ぺ イ ン タ の対話型 SQL ビ ュ ーの SQL 文を再 コ ンパ
イ ル し ま す （詳 し い手順については、 『ユーザーズ ガ イ ド 』 マニ ュ
アル を参照 し て く だ さ い）。
PowerBuilder
第1章
DBParm パ ラ メ ー タ
デー タ ウ ィ ン ド ウ オブ ジ ェ ク ト ま たは レ ポー ト と DBMS 結果集合の
情 報 が 一 致 し な い と き に、 エ ラ ー が 発 生 し な い よ う に す る に は、
StaticBind DBParm パ ラ メ ー タ を 0 ま た は No に 設 定 し て、 常 に
PowerBuilder がデー タ ウ ィ ン ド ウ オブジ ェ ク ト ま たは レ ポー ト にデー
タ を取得す る 前に結果集合情報を入手す る よ う に し ま す。
例
PowerBuilder が、 デー タ ウ ィ ン ド ウ オ ブ ジ ェ ク ト ま た は レ ポ ー ト に
デー タ を取得す る 前に、 結果集合の情報を入手す る こ と を指定す る に
は以下の よ う に し ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ ト ラ ン ザ ク シ ョ ン］ タ ブ （OLE DB イ ン タ フ ェ ー ス の場合
［シ ス テ ム］ タ ブ） で、 ［静的バ イ ン ド ］ チ ェ ッ ク ボ ッ ク ス を オ フ
に し ま す。
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
デー タ ベース プ ロ フ ァ イル
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で、 以下の入力を行い ま す。
アプ リ
SQLCA.dbParm = "StaticBind = 0"
StripParmNames
機能
明示的に名前を付け ら れたパ ラ メ ー タ を ODBC ド ラ イ バに渡す こ と を
許可 し ま せん。
対象
ODBC
構文
StripParmNames = "value"
パラ メ ー タ
value
説明
明示的に名前 を 付け ら れ たパ ラ メ ー タ を ODBC ド ラ イ バ
に渡す こ と を許可 し ません。 以下のいずれかの値 を指定 し
ま す。
• Yes 生成 さ れた CallEscape 構文か ら パ ラ メ ー タ 名 をす
べて削除 し ます。
• No （デ フ ォ ル ト ） 生成 さ れた CallEscape 構文内に明示
的に指定 さ れたパ ラ メ ー タ 名が含 まれ る場合に、 それを
維持 し ます。
デ フ ォル ト 値
StripParmNames = "No"
解説
デフ ォ ル ト では、 ス ト ア ド プ ロ シージ ャ の実行で明示的にパ ラ メ ー タ
名が指定 さ れた場合、 PowerBuilder はそのパ ラ メ ー タ 名を維持 し ま す。
その結果、 た と えば以下の よ う な構文が生成 さ れ、 ODBC ド ラ イ バに
送 ら れ ま す。
接続 リ フ ァ レ ン ス
185
SvrFailover
{call proc(a=?,b=?)}
デー タ ベース ベン ダに よ っ ては、 生成 さ れた CallEscape 構文内でパ ラ
メ ー タ 名を指定す る こ と を認めてい ま せん。 明示的に名前を付け ら れ
た パ ラ メ ー タ を ODBC
ド ラ イ バ に 渡 す こ と を 禁 止 す る に は、
StripParmNames を Yes に設定 し ま す。 こ れは、 パ ラ メ ー タ が指定順に
渡 さ れ る こ と を意味 し ま す。
例
ス ト ア ド プ ロ シージ ャ か ら 明示的に指定 さ れたパ ラ メ ー タ 名を取 り 除
く には、 以下の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［構文］ タ ブの ［パ ラ メ ー タ 名 を取 る ］ チ ェ ッ ク ボ ッ ク ス
を オ ン に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で以下の入力を行い ま す。
アプ リ
SQLCA.dbParm = "StripParmNames = 'Yes'"
SvrFailover
機能
現行のデー タ ベース サーバがダ ウ ン し た と き に、 フ ェ イ ルオーバ内の
指定のバ ッ ク ア ッ プ デー タ ベー ス サーバ を PowerBuilder が認識 し て
それに参加す る こ と を指示 し ま す。
SvrFailover を指定する タ イ ミ ン グ
SvrFailover DBParm パ ラ メ ー タ は、PowerBuilder か ら デー タ ベース に接
続す る 前に指定 し ま す。
対象
O84 Oracle 8.x お よ び Oracle8i （8.1.5 以降のデー タ ベース 接続のみ）
O90 Oracle9i
SYC Sybase Adaptive Server Enterprise （12.0 以降のデー タ ベー ス 接続の
み）
SYJ Sybase Adaptive Server Enterprise
構文
SvrFailover = 'value'
186
PowerBuilder
第1章
パラ メ ー タ
value
DBParm パ ラ メ ー タ
説明
現行のデー タ ベー ス サーバが ダ ウ ン し た と き に、 フ ェ イ
ル オーバ で指定の バ ッ ク ア ッ プ デー タ ベー ス サーバ を
PowerBuilder が認識 し て そ れに参加す る こ と を 指示 し ま
す。 以下のいずれかの値を指定 し ます。
• No （デ フ ォ ル ト ） PowerBuilder が フ ェ イ ルオーバ を認
識 ま たは参加す る こ と を許可 し ません。
• Yes PowerBuilder が フ ェ イ ルオーバ を認識 し 、 それに
参加 し ます。
デ フ ォル ト 値
SvrFailover = 'No'
解説
Oracle お よ び Sybase のサポー ト デー タ ベース サーバは と も に、Oracle
Version 8.1.5 お よ び Adaptive Server 12 以降で フ ェ イ ルオーバ し ま す。こ
れ ら のデー タ ベー ス サーバの フ ェ イ ルオーバ を 構成す る 方法につい
ての詳細は、 Oracle ま たは Adaptive Server の ド キ ュ メ ン ト を参照 し て
く だ さ い。 フ ェ イ ル オ ー バ の 発 生 時 に、 タ イ ム ア ウ ト の 結 果
PowerBuilder デー タ ベー ス 接続 が 喪失す る こ と を 回避す る た め に、
SvrFailover DBParm を 設定す る こ と で、 PowerBuilder にデー タ ベー ス
サーバ フ ェ イ ルオーバを認識お よ び参加 さ せま す。
Oracle では、 フ ェ イ ルオーバ プ ロ セ ス を一部管理で き ま す。 さ ら にほ
かの 3 つの DBParms を使用す る こ と で、接続す る デー タ ベース サーバ
において フ ェ イ ルオーバを試み る 回数、 フ ェ イ ルオーバを試み る ま で
の待機時間、 PowerBuilder で フ ェ イ ルオーバの発生を 示す実行時のダ
イ ア ロ グ ボ ッ ク ス を表示す る か ど う か を指定で き ま す。
こ のパ ラ メ ー タ は、 動的設定にで き ま せん。 接続の確立時に設定 さ れ
た値は、 接続が切断す る ま で有効です。
例
フ ェ イ ルオーバを認識 し 、 それに参加す る よ う に指示す る には、 以下
の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［ネ ッ ト ワー ク ］ タ ブの ［サーバ フ ェ イ ル オーバーを許可
す る ］ チ ェ ッ ク ボ ッ ク ス を オ ンに し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に以下を入力 し ま す。
SQLCA.DBParm = "SvrFailover = 'Yes'"
関連項目
接続 リ フ ァ レ ン ス
FoDelay
FoDialog
FoRetryCount
187
SystemProcs
SystemProcs
機能
ス ト ア ド プ ロ シージ ャ の リ ス ト を要求 し た と き に、 接続 し てい る デー
タ ベース におけ る 、シ ス テ ム ス ト ア ド プ ロ シージ ャ と ユーザ定義ス ト
ア ド プ ロ シージ ャ の両方を表示す る か ど う か を指定す る 値。
デフ ォ ル ト では、 接続 し てい る デー タ ベー ス におけ る 、 シ ス テ ム ス ト
ア ド プ ロ シージ ャ と ユーザ定義 ス ト ア ド プ ロ シージ ャ の両方が表示
さ れ ま す。 SystemProcs パ ラ メ ー タ を 0 ま たは No に設定す る と 、 ユー
ザ定義ス ト ア ド プ ロ シージ ャ だけが表示 さ れ ま す。
対象
MSS Microsoft SQL Server
SYC Sybase Adaptive Server Enterprise
構文
SystemProcs = value
パラ メ ー タ
value
説明
ス ト ア ド プ ロ シージ ャ の リ ス ト を要求 し た と き に、 接続 し
てい る デー タ ベー ス におけ る 、 シ ス テ ム ス ト ア ド プ ロ シー
ジ ャ と ユーザ定義 ス ト ア ド プ ロ シージ ャ の両方を表示す る
か ど う か を指定す る 値。 以下のいずれかの値を指定 し ます。
• 0 ユーザ定義 ス ト ア ド プ ロ シージ ャ だ け を表示 し ます。
'No' と 指定 し て、 こ の値を設定す る こ と も で き ます。
• 1 （デ フ ォ ル ト ） シ ス テ ム ス ト ア ド プ ロ シージ ャ と ユー
ザ 定 義 ス ト ア ド プ ロ シ ー ジ ャ の 両 方 を 表 示 し ま す。
'Yes' と 指定 し て、 こ の値を設定す る こ と も で き ます。
デフ ォル ト 値
SystemProcs = 1
解説
ユーザ定義ス ト ア ド プロ シージャ だけを 操作し たい場合は、SystemProcs
パ ラ メ ー タ を 0 ま たは No に設定す る と 、 応答時間を短縮で き ま す。
例
ス ト ア ド プ ロ シージ ャ の リ ス ト を要求 し た と き に、 接続 し てい る デー
タ ベー ス にユーザ定義 ス ト ア ド プ ロ シージ ャ だ け を 表示す る こ と を
指定す る には以下の よ う に し ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［シ ス テ ム］ タ ブの ［シ ス テ ム ス ト ア ド プ ロ シージ ャ を表
示］ チ ェ ッ ク ボ ッ ク ス を オ フ に し ま す。
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
デー タ ベース プ ロ フ ァ イル
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で、 以下の入力を行い ま す。
アプ リ
SQLCA.dbParm = "SystemProcs = 0"
188
PowerBuilder
第1章
DBParm パ ラ メ ー タ
TableCriteria
機能
PowerBuilder の ［使用で き る DB イ ン タ フ ェ ー ス ］ リ ス ト に表示す る
テ ーブ ルお よ び ビ ュ ーの リ ス ト を 制限す る 検索条件 を 指定 し ま す。
PowerBuilder 開発環境で非常に大規模なデー タ ベー ス で作業をす る 場
合に、 こ のパ ラ メ ー タ はたいへん効果的です。
TableCriteria を指定する タ イ ミ ン グ
TableCriteria DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー ス に
接続す る 前に指定 し ま す。
TableCriteria DBParm パ ラ メ ー タ は、 PowerBuilder アプ リ ケーシ ョ ン の
ス ク リ プ ト では無効です。
対象
JDB JDBC
ODBC
O73 Oracle 7.3
O84 Oracle 8.x お よ び Oracle8i
O90 Oracle9i
SYC Sybase Adaptive Server Enterprise
構文
テーブルの抽出条件を、 DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク ス の
［シ ス テ ム］ タ ブで指定 し ま す。
デ フ ォル ト 値
な し 。値を指定 し ない場合、TableCriteria パ ラ メ ー タ は使用 さ れ ま せん。
Oracle TableCriteria に値が指定 さ れていない場合、 ア ク セ ス で き る す
べての Oracle テーブル、 ビ ュ ー、 お よ びシ ノ ニ ム がデフ ォ ル ト で ［使
用で き る DB イ ン タ フ ェ ース ］ リ ス ト に表示 さ れ ま す。
解説
テーブルの抽出条件を指定す る には、 以下のボ ッ ク ス に情報を入力 し
ま す。
フ ィ ール ド
説明
テーブル名
現行のデー タ ベース で表示す る テーブルの名前を指定 し ま
す。 ワ イ ル ド カー ド を使用で き ま す。
Adaptive Server Enterprise イ ン タ フ ェ ースのデ フ ォ ル ト
Adaptive Server Enterprise イ ン タ フ ェ ー ス を介 し て接続す る
場合に こ の値を省略す る と 、 現行デー タ ベー ス のすべての
テーブルが表示 さ れ ます。
テーブル オー
ナ
指定 さ れた テーブル オーナに属す る テーブルだ けが表示
さ れま す。 ワ イ ル ド カー ド を使用で き ます。
こ の値を省略す る と 、 ア ク セ ス で き る テーブル名 と 一致す
る すべてのテーブルが表示 さ れま す。
テーブル を含
める
接続 リ フ ァ レ ン ス
テーブルが表示 さ れ る よ う 指定 し ます。
189
ThreadSafe
フ ィ ール ド
説明
ビ ュ ー を含め
る
ビ ューが表示 さ れ る よ う 指定 し ます。
シ ス テ ム テー
ブル を含め る
シ ス テ ム テーブルが表示 さ れ る よ う 指定 し ま す。
エ リ ア ス を含
める
エ リ ア ス テーブルが表示 さ れ る よ う 指定 し ま す。
シ ノ ニ ム を含
める
シ ノ ニ ム テーブルが表示 さ れ る よ う 指定 し ま す。
Adaptive Server Enterprise こ れ ら の Sybase デ ー タ ベー ス イ ン タ
フ ェ ース は、ス ト ア ド プ ロ シージ ャ を使用 し て テーブル リ ス ト を作成
し ま す。
•
開発者 ま たはデー タ
ベー ス 管理者に よ っ て イ ン ス ト ール さ れた sp_pb90table ス ト ア ド
プ ロ シージ ャ を使用 し ま す。
Adaptive Server Enterprise イ ン タ フ ェ ース
Adaptive Server Enterprise デー タ ベース に接続す る 場合に ど のバー
ジ ョ ン の sp_pb90table を イ ン ス ト ールす る かについては、 『デー タ
ベース と の接続』 マニ ュ アルを参照 し て く だ さ い。
PowerBuilder は、TableCriteria DBParm パ ラ メ ー タ を使用 し て、sp_tables
ま たは sp_pb90table に引数を渡 し 、 検索基準に基づいて テーブル リ ス
ト を作成 し ま す。
例
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク ス の ［シ ス テ ム］ タ ブの ［テー
ブル オーナ］ ボ ッ ク ス に DWMC31 を入力 し 、 ［テーブル名］ ボ ッ ク ス に
QADB% を入力 し ま す。
"TableCriteria='"QADB%","DWMC31"'"
ThreadSafe
機能
接続でデー タ ベー ス サーバの ス レ ッ ド 保障 ク ラ イ ア ン ト ラ イ ブ ラ リ
を利用す る か ど う か指定 し ま す。
デフ ォ ル ト では、 ThreadSafe は No に設定 さ れ、 接続には ス レ ッ ド 保障
ク ラ イ ア ン ト ラ イ ブ ラ リ が使用 さ れ ま せん。 ThreadSafe を Yes に設定
す る と 、 接続に ス レ ッ ド 保障 ク ラ イ ア ン ト ラ イ ブ ラ リ が使用 さ れ ま
す。
190
PowerBuilder
第1章
DBParm パ ラ メ ー タ
ThreadSafe を指定する タ イ ミ ン グ
ThreadSafe DBParm パ ラ メ ー タ は、PowerBuilder か ら デー タ ベース に接
続す る 前に指定 し ま す。
対象
IN9 INFORMIX
O73 Oracle 7.3
O84 Oracle 8.x お よ び Oracle8i
O90 Oracle9i
構文
ThreadSafe = 'value'
パラ メ ー タ
value
説明
接続でデー タ ベー ス サーバの ス レ ッ ド 保障 ク ラ イ ア
ン ト ラ イ ブ ラ リ を使用す る か ど う か指定 し ます。以下
のいずれかの値を指定 し ます。
• Yes 接続に ス レ ッ ド 保障 ク ラ イ ア ン ト ラ イ ブ ラ
リ が使用 さ れます。 こ の設定値は、 マルチ ス レ ッ ド
環境 を 要求す る 分散 ア プ リ ケー シ ョ ン を 作成す る
と き に使い ます。
• No （デ フ ォ ル ト ） 接続に ス レ ッ ド 保障 ク ラ イ ア ン
ト ラ イ ブ ラ リ が使用 さ れません。 こ の設定値は、単
一 ス レ ッ ド 環境 を要求す る 非分散ア プ リ ケ ーシ ョ
ン を作成す る と き に使い ます。
デ フ ォル ト 値
ThreadSafe = 'No'
解説
設定が必要な場合 Oracle お よ び Informix は、 ク ラ イ ア ン ト ラ イ ブ ラ
リ で ス レ ッ ド 保障 の サ ポ ー ト を 提 供 し て い ま す。 PowerBuilder で、
Oracle ま たは Informix デー タ ベース イ ン タ フ ェ ース を使用 し て、 マル
チ ス レ ッ ド ア プ リ ケーシ ョ ン を 作成す る 場合は、 ThreadSafe DBParm
パ ラ メ ー タ を Yes に設定 し て、 ス レ ッ ド 保障 ク ラ イ ア ン ト ラ イ ブ ラ リ
を使用す る 必要があ り ま す。 こ れに よ り 、 デー タ ベース サーバに呼び
出 し を行 う 複数の実行 ス レ ッ ド の間で発生す る 可能性が あ る 悪影響を
防 ぐ こ と がで き ま す。 ただ し 、 ス レ ッ ド 保障 ク ラ イ ア ン ト ラ イ ブ ラ リ
を使用す る 場合には、 ア プ リ ケーシ ョ ン に よ り 、 パ フ ォ ーマ ン ス 違反
が発生す る こ と も あ る こ と に注意 し て く だ さ い。
接続 リ フ ァ レ ン ス
191
Time
デ フ ォ ル ト では、 ク ラ イ ア ン ト ソ フ ト ウ ェ ア （お よ び PowerBuilder）
は、 ス レ ッ ド 保障 ク ラ イ ア ン ト ラ イ ブ ラ リ を 必要 と し な い、 単一 ス
レ ッ ド 環境の ア プ リ ケ ーシ ョ ン の作成 を 前提 と し て い ま す。 こ のデ
フ ォ ル ト 設定に よ り 、 単一ス レ ッ ド アプ リ ケーシ ョ ン では、 ス レ ッ ド
保障 ク ラ イ ア ン ト ラ イ ブ ラ リ の使用に関連す る パ フ ォ ーマ ン ス 違反
は起 こ ら ない こ と が保障 さ れ ま す。 し たが っ て、 単一ス レ ッ ド アプ リ
ケーシ ョ ン を作成す る 場合は、ThreadSafe DBParm パ ラ メ ー タ を その ま
ま No （デフ ォ ル ト ） に設定 し ておいて構い ま せん。
プ ラ ッ ト フ ォーム固有の違い Oracle 7.3 ク ラ イ ア ン ト ラ イ ブ ラ リ に
おけ る ス レ ッ ド 保障のサポー ト は、 すべてのオペレーテ ィ ン グ シ ス テ
ム プ ラ ッ ト フ ォーム で有効で あ る わけでは あ り ま せん。 使用 し てい る
プ ラ ッ ト フ ォ ーム での ス レ ッ ド 保障のサポー ト については、 Oracle シ
ス テ ム のマニ ュ アルを参照 し て く だ さ い。
こ のパ ラ メ ー タ は、 動的設定にで き ま せん。 接続の確立時に設定 さ れ
た値は、 接続が切断す る ま で有効です。
例
使用 し て い る 接続で ス レ ッ ド 保障 ク ラ イ ア ン ト ラ イ ブ ラ リ を 使用す
る よ う に指定す る には、 以下の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス で、 ［接続］ タ ブの ［ ス レ ッ ド セーフ］ チ ェ ッ ク ボ ッ ク ス を オ
ン に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に以下を入力 し ま す。
SQLCA.DBParm = "ThreadSafe = 'Yes'"
Time
機能
デー タ ウ ィ ン ド ウ ペ イ ン タ でデー タ を更新す る と き に、 PowerBuilder
ではバ ッ ク グ ラ ン ド で SQL UPDATE 文が作成 さ れ ま す。 Time DBParm
パ ラ メ ー タ では、 SQL UPDATE 文で使用す る Time デー タ 型の書式が
決定 さ れ ま す。
対象
JDB JDBC
ODBC
O73 Oracle 7.3
O84 Oracle 8.x お よ び Oracle8i
O90 Oracle9i
構文
Time DBParm パ ラ メ ー タ を指定す る 構文は、 デー タ ベース に よ っ てわ
ずかに異な り ま す。
192
PowerBuilder
第1章
DBParm パ ラ メ ー タ
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク ス で、 必要な場所に特殊文字
（引用符 と 円記号） が挿入 さ れ る ので、 指定す る のは Time 型書式だけ
でか ま い ま せん。
PowerBuilder ア プ リ ケーシ ョ ン の ス ク リ プ ト では、 以下の構文を 使用
す る 必要があ り ま す。
JDBC / ODBC 構文 PowerBuilder 円記号 と こ れに続 く 2 つの単一引用
符 （￥''） は、 SQL UPDATE 文が作成 さ れ る と き には 1 つの単一引用符
と し て解析 さ れ ま す。
Time = ' ¥''time_format¥'' '
PowerBuilder 連続す る 4 つの単一引用符 （''''） は、 SQL
UPDATE 文が作成 さ れ る と き には 1 つの単一引用符 と し て解析 さ れ ま
す。
Oracle 構文
Time = ' ''''time_format'''' '
パラ メ ー タ
' ¥''
' ''''
time_format
¥'' '
'''' '
デ フ ォル ト 値
接続 リ フ ァ レ ン ス
説明
単一引用符、スペー ス、円記号、
2 つの単一引用符の順に指定 し ます。 連続す る 2 つ
の単一引用符 と 、 Time 型書式の間に ス ペー スは入
れません。
Oracle 構文 単一引用符、 スペー ス 、 4 つの単一引
用符の順に指定 し ま す。 連続す る 4 つの単一引用
符 と 、 Time 型書式の間に スペー ス は入れ ません。
デー タ ウ ィ ン ド ウ ペ イ ン タ において、 デー タ ソ ー
ス を更新す る ために SQL UPDATE 文を作成す る と
き に、 PowerBuilder で使用 さ れ る Time 型の書式
JDBC / ODBC 構文
表示書式につい ては、 『ユーザーズ ガ イ ド 』 マニ ュ
アル を参照 し て く だ さ い。
JDBC / ODBC 構文 円記号、 2 つの単一引用符、 ス
ペー ス、 単一引用符の順に指定 し ま す。 Time 型書
式 と 円記号の間に スペー ス は入れません。
Oracle 構文 4 つの単一引用符、 スペー ス、 単一引
用符の順に指定 し ます。 Time 型書式 と 、4 つの連続
す る単一引用符の間に スペー ス は入れません。
Time のデ フ ォ ル ト 値は、 ア ク セ ス し て い る DBMS に よ っ て異な り ま
す。
193
Time
DBMS
デフ ォル ト 値
JDBC
Time DBParm パ ラ メ ー タ に値が指定 さ れていない場合、使用
し て い る JDBC ド ラ イ バ に 対応 す る レ ジ ス ト リ 内 の セ ク
シ ョ ン で Time 型書式が 検索 さ れ ま す。 レ ジ ス ト リ の 中 で
Time 型書式が見つか ら ない場合は、 JDBC の Time 型書式エ
ス ケープ シーケ ン ス が使用 さ れ ます。
ODBC
Time DBParm パ ラ メ ー タ に 値 が 指 定 さ れ て い な い 場 合、
PBODB90 初期設定 フ ァ イ ルの ODBC ド ラ イ バに対応す る セ
ク シ ョ ン で Time 型書式が検索 さ れ ます。 PBODB90 初期設定
フ ァ イ ルの中で Time 型書式が見つか ら な い場合は、 ODBC
の Time 型書式エ ス ケープ シーケ ン ス が使用 さ れ ます。
Oracle
デフ ォ ル ト の Oracle Time 型書式が使用 さ れ ます。
詳細については、 Oracle のマニ ュ アル を参照 し て く だ さ い。
例
Start カ ラ ム を 08:30 に設定する こ と によ り 、Workhours
と い う 名前のテーブル を更新す る も の と し ま す。 こ の時刻は、 以下の
PowerBuilder Time 型書式で表 さ れ ま す。
以下の例につい て
hh:mm
例 1 （JDBC / ODBC 構文） SQL UPDATE 文 を 作 成す る と き に、 こ の
Time デー タ 型書式 を 使用す る こ と を 指定す る には以下の よ う に し ま
す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［構文］ タ ブの ［Time 型の書式］ ボ ッ ク ス で、 以下の入力
を行い ま す。
デー タ ベース プ ロ フ ァ イル
hh:mm
•
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で以下の入力を行い ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "Time = ' ¥''hh:mm¥'' '"
作成 さ れ る SQL UPDATE 文 PowerBuilder は、以下の SQL UPDATE 文
を作成 し て テーブルを更新 し ま す。
UPDATE WORKHOURS
SET START = '08:30'
SQL UPDATE 文を作成す る と き に、こ の Time デー
タ 型書式を使用す る こ と を指定す る には以下の よ う に し ま す。
例 2 （Oracle 構文）
•
194
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［構文］ タ ブ の ［Time 型の書式］ ボ ッ ク ス に hh:mm と 入
力 し ま す。
デー タ ベース プ ロ フ ァ イル
PowerBuilder
第1章
•
DBParm パ ラ メ ー タ
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で以下の入力を行い ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "Time = ' ''''hh:mm'''' '"
作成 さ れ る SQL UPDATE 文 PowerBuilder は、以下の SQL UPDATE 文
を作成 し てテーブルを更新 し ま す。
UPDATE WORKHOURS
SET START = '08:30'
関連項目
Date
DateTime
TimeFormat
機能
デー タ ウ ィ ン ド ウ ペ イ ン タ でデー タ を更新す る と き に、 PowerBuilder
ではバ ッ ク グ ラ ン ド で SQL UPDATE 文が作成 さ れ ま す。 Time DBParm
パ ラ メ ー タ では、 SQL UPDATE 文で使用す る Time デー タ 型の書式が
決定 さ れ ま す。
対象
OLE DB
構文
TimeFormat ='time_format'
パラ メ ー タ
time_format
説明
デー タ ウ ィ ン ド ウ ペ イ ン タ において、 デー タ ソ ー
ス を更新す る ために SQL UPDATE 文を作成す る と
き に、 PowerBuilder で使用 さ れ る Time 型の書式
表示書式につい ては、 『ユーザーズ ガ イ ド 』 マニ ュ
アル を参照 し て く だ さ い。
デ フ ォル ト 値
TimeFormat DBParm パ ラ メ ー タ に値が指定 さ れ て い な い場合、 Time
デー タ 型は使用 さ れ ま せん。
例
Start カ ラ ム を 08:30 に設定す る こ と に よ り 、 Workhours と い う 名前の
テーブル を更新す る も の と し ま す。 こ の時刻は、 以下の PowerBuilder
Time 型書式で表 さ れ ま す。
hh:mm
SQL UPDATE 文を作成す る と き に、 こ の Time デー タ 型書式を使用す
る こ と を指定す る には以下の よ う に し ま す。
•
接続 リ フ ァ レ ン ス
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［構文］ タ ブの ［Time 型の書式］ ボ ッ ク ス で、 以下の入力
を行い ま す。
デー タ ベース プ ロ フ ァ イル
195
TimeOut
hh:mm
•
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で以下の入力を行い ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "TimeFormat='hh:mm'î
作成 さ れ る SQL UPDATE 文 PowerBuilder は、以下の SQL UPDATE 文
を作成 し て テーブルを更新 し ま す。
UPDATE WORKHOURS
SET START = '08:30'
関連項目
DateFormat
DateTimeFormat
TimeOut
機能
デー タ プ ロ バ イ ダ と の接続が完了す る の を OLE DB イ ン タ フ ェ ース が
待つ秒数を指定 し ま す。
対象
OLE DB
構文
TimeOut = value
パラ メ ー タ
value
説明
接続が完了す る の を OLE DB イ ン タ フ ェ ー ス が待つ秒数
デフ ォル ト 値
なし
解説
TimeOut DBParm のデフ ォ ル ト 値は ド ラ イ バに よ っ て異な り ま す。
例
接続が完了す る の を 10 秒待つ よ う に TimeOut 値を設定す る には以下
の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［シ ス テ ム］ タ ブの ［ タ イ ム ア ウ ト ］ ボ ッ ク ス に 10 と 入力
し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で以下の入力を行い ま す。
アプ リ
SQLCA.dbParm = "TimeOut = 10"
196
PowerBuilder
第1章
DBParm パ ラ メ ー タ
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 DBParm パ ラ メ ー タ を
指定すれば、 PowerBuilder ア プ リ ケ ー シ ョ ン で JDBC Driver Manager
Trace を開始お よ び停止で き ま す。
JDBC Driver Manager Trace ツールの使い方については、 『デー タ ベー ス
と の接続』 マニ ュ アル を参照 し て く だ さ い。
例
JDBC Driver Manager Trace を開始 し 、 ロ グ フ ァ イ ル を指定す る には、
以下の よ う に し ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［オプ シ ョ ン］ タ ブで、 ［JDBC コ ール を ト レ ース ］ チ ェ ッ
ク ボ ッ ク ス を オ ンに し 、 ［ ト レー ス フ ァ イ ル］ ボ ッ ク ス で以下の入
力 を行い ま す。
デー タ ベース プ ロ フ ァ イル
c:¥temp¥jdbctrce.log
•
PowerBuilder
ケーシ ョ ンの ス ク リ プ ト で以下の入力を行い ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "TraceFile = 'c:¥temp¥jdbctrce.log'"
接続 リ フ ァ レ ン ス
197
TrimSpaces
TrimSpaces
機能
以下のデー タ 型か ら 取 り 出 さ れたデー タ 値か ら 、 後続ス ペー ス を削除
す る か ど う か を指定 し ま す。 Char、 Char for Bit Data、 VarChar、 お よ び
VarChar for Bit Data。
対象
JDB JDBC
SYC お よ び SYJ Sybase Adaptive Server Enterprise
構文
TrimSpaces = value
パラ メ ー タ
value
説明
デー タ 型 Char、 Char for Bit Data、 お よ び VarChar for
Bit Data か ら 後続 スペー ス を削除す る か ど う か を指定
し ます。 以下のいずれかの値を指定 し ます。
• 0 後続 スペー ス を削除 し ません。
• 1 （デフ ォ ル ト ） 後続 スペー ス を削除 し ます。
デフ ォル ト 値
TrimSpaces = 1
解説
デフ ォ ル ト では、 Char、 Char for Bit Data、 VarChar、 VarChar for Bit Data
の各デー タ 型の場合、 ス ペー ス が削除 さ れ ま す。
WHERE 句の評価時に、 後続 ス ペー ス 付 き の CHAR デー タ と 後続 ス
ペー ス な し の CHAR デー タ を 区別す る DBMS を 使用 し て い る 場合、
デー タ ウ ィ ン ド ウ の更新特性を " キー カ ラ ムお よ び更新可能カ ラ ム "
に設定 し てい る と 、「検索 と 更新の間に行が変更 さ れ ま し た。」 メ ッ セー
ジが表示 さ れ る こ と があ り ま す。 こ の メ ッ セージが表示 さ れない よ う
にす る は、 デー タ ウ ィ ン ド ウ の更新特性を変更 し ま す。 埋め込み SQL
の場合は、更新後に毎回 Sqlca.Sqlnrows を チ ェ ッ ク す る こ と に よ り 、更
新が実際に実行 さ れた か ど う か を 知 る こ と がで き ま す。 TrimSpaces=1
の場合は、 UPDATE 文ま たは DELETE 文の WHERE 句で、 CHAR 型の
デー タ カ ラ ム を使用す る こ と を避け て く だ さ い。
例
PowerBuilder で後続 ス ペー ス を削除 し な い よ う に指示す る には、 以下
の よ う に し ま す。
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［構文］ タ ブの ［CHAR デー タ 中の後続の空白を と る ］ チ ェ ッ
ク ボ ッ ク ス を オ フ に し ま す。
•
デー タ ベース プ ロ フ ァ イル
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
PowerBuilder ス ク リ プ
ト に以下を入力 し ま す。
SQLCA.DBParm = "TrimSpaces = 0"
198
PowerBuilder
第1章
DBParm パ ラ メ ー タ
URL
機能
JDBC イ ン タ フ ェ ー ス を 使用 し て接続す る デー タ ベー ス の位置を指定
し ま す。
URL を指定する タ イ ミ ン グ
URL DBParm パ ラ メ ー タ は、 PowerBuilder か ら デー タ ベー ス に接続す
る 前に指定す る 必要があ り ま す。
対象
JDB JDBC
構文
URL = 'URL_address'
デ フ ォル ト 値
なし
解説
デー タ ベース の URL は、デー タ ベー ス の JDBC ド ラ イ バの ド キ ュ メ ン
ト か ら 取得で き ま す。登録済みの Driver ク ラ ス と それ ら の URL の リ ス
ト は、 ド ラ イ バの JDBC DriverManager ク ラ ス で管理 さ れ ま す。 接続が
リ ク エ ス ト さ れ る と 、DriverManager は リ ス ト の中か ら 適切な ド ラ イ バ
を見つけ ま す。
URL は、 以下の一般書式を使用 し ま す。
jdbc:vendor:driverprotocol:servername:port/database
引数
jdbc
vendor
driverprotocol
servername
port
database
説明
ド ラ イバ
デー タ ベー ス のベン ダ （Sybase ま たは Oracle な ど ）
デー タ ベー ス の通信プ ロ ト コ ル
DNS マシ ン名ま たはデー タ ベース ホ ス ト 名
デー タ ベー ス サーバ に ア ク セ ス す る た め の TCP/IP
ポー ト 番号
（オプシ ョ ン） 特定のデー タ ベー ス の名前
デー タ ベース の URL には、 以下の よ う にユーザ ID と パ ス ワ ー ド を含
め る こ と がで き ま す。
jdbc:vendor:driverprotocol:userid/password@servername:port:database
例
jConnect を介 し て ア ク セ ス さ れ る デー タ ベース の URL を設定す
る には以下の よ う に し ま す。
例1
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［接続］ タ ブの ［URL］ ボ ッ ク ス で以下の入力を行い ま す。
デー タ ベース プ ロ フ ァ イル
jdbc:sybase:Tds:199.93.178.151:5007/tsdata
接続 リ フ ァ レ ン ス
199
UseContextObject
•
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で以下の入力を行い ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "URL =
'jdbc:sybase:Tds:199.93.178.151:5007/tsdata'"
Oracle JDBC ド ラ イ バ を 介 し て ア ク セ ス さ れ る デー タ ベー ス の
URL を設定す る には以下の よ う に し ま す。
例2
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［接続］ タ ブの ［URL］ ボ ッ ク ス で以下の入力を行い ま す。
デー タ ベース プ ロ フ ァ イル
jdbc:oracle:thin:@ora80nt:1521:orcl
•
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で以下の入力を行い ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "URL =
'jdbc:oracle:thin:@ora80nt:1521:orcl'"
Oracle JDBC ド ラ イ バ を介 し て ア ク セ ス さ れ る デー タ ベー ス の、
ユーザ ID と パ ス ワ ー ド を含む URL を設定す る には以下の よ う に し ま
す。
例3
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［接続］ タ ブの ［URL］ ボ ッ ク ス で以下の入力を行い ま す。
デー タ ベース プ ロ フ ァ イル
jdbc:oracle:thin:system/manager@ora80nt:1521:orcl
•
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で以下の入力を行い ま す。
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
アプ リ
SQLCA.dbParm = "URL =
'jdbc:oracle:thin:system/manager@ora80nt:1521:orcl'
"
関連項目
Driver
UseContextObject
機能
PowerBuilder が ト ラ ン ザ ク シ ョ ン サービ ス コ ン テ キ ス ト オブ ジ ェ ク
ト の TransactionServer を使用 し て ト ラ ン ザ ク シ ョ ン を制御す る よ う に
指定 し ま す。 こ の DBParm パ ラ メ ー タ は、 PowerBuilder カ ス タ ム ク ラ
ス ユーザ オブ ジ ェ ク ト が EAServer コ ン ポーネ ン ト ま たは MTS コ ン
ポーネ ン ト と し て配布 さ れ る 場合だけ使用 し ま す。
対象
JDB JDBC
ODBC
O73 Oracle 7.3
200
PowerBuilder
第1章
DBParm パ ラ メ ー タ
O84 Oracle 8.x お よ び Oracle8i
O90 Oracle9i
SYJ Sybase Adaptive Server Enterprise
デー タ ベース イ ン タ フ ェ ースの制限
MTS は ODBC、 Oracle O84、 Oracle O90 イ ン タ フ ェ ース をサポー ト
MTS で Oracle Version 8.1.5 以降のデー タ ベー ス に接続す る 場合、 デー
タ ベー ス ト ラ ン ザ ク シ ョ ンがサポー ト さ れ る のは、ODBC、Oracle O84、
お よ び Oracle O90 イ ン タ フ ェー ス を経由す る 時です。
Sybase EAServer では、 わず
か に異な る バージ ョ ン の CT-Lib ソ フ ト ウ ェ ア が使用 さ れ ま す。 し た
が っ て、 実行時に、 Adaptive Server Enterprise デー タ ベース に接続す る
には SYC では な く SYJ デー タ ベース イ ン タ フ ェー ス を使用す る 必要
があ り ま す。 SYJ の DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク ス を使用
す る と 、 適切な接続パ ラ メ ー タ が設定 さ れ、 構文を ［プ レ ビ ュ ー］ タ
ブ か ら ト ラ ン ザ ク シ ョ ン オ ブ ジ ェ ク ト の ス ク リ プ ト に コ ピ ーで き ま
す。
SYJ イ ン タ フ ェ ース を必要 と す る EAServer
ただ し 、 PowerBuilder 開発環境か ら デー タ ベー ス に接続す る 場合には
SYJ イ ン タ フ ェー ス を使用で き ま せん。 し たが っ て、 開発段階では （ コ
ン ポーネ ン ト が EAServer に配布 さ れ る 前） 、 SYC を 使用 し てデー タ
ベース に接続す る 必要があ り ま す。
構文
UseContextObject = 'value'
デ フ ォル ト 値
UseContextObject = No
解説
PowerBuilder には、EAServer ま たは MTS が現行の ト ラ ンザ ク シ ョ ン を
コ ミ ッ ト す る か、 中止す る かに影響を与え る ト ラ ン ザ ク シ ョ ン状態プ
リ ミ テ ィ ブへのア ク セ ス を提供す る 、TransactionServer と い う ト ラ ン ザ
ク シ ョ ン サー ビ ス コ ン テ キ ス ト オブ ジ ェ ク ト が用意 さ れ てい ま す。
UseConnectObject DBParm を Yes に設定 し て TransactionServer コ ン テ キ
ス ト オ ブ ジ ェ ク ト を 使用す る 場合、 COMMIT 文 と ROLLBACK 文が
Transaction オブ ジ ェ ク ト で呼び出 さ れ る と 実行時エ ラ ーにな り ま す。
デフ ォ ル ト では、 TransactionServer コ ン テ キ ス ト オブ ジ ェ ク ト は使用
さ れ ま せん。 代わ り に、 COMMIT 文 と ROLLBACK 文を使用 し て ト ラ
ンザ ク シ ョ ン を管理で き ま す。 こ の場合、 COMMIT は SetComplete 関
数 と し て解釈 さ れ、 ROLLBACK は SetAbort 関数 と し て解釈 さ れ ま す。
こ の方法は、 PowerBuilder 6.x 以前のオブ ジ ェ ク ト を、 コ ー ド を変更 し
な い で EAServer ま た は MTS に移植す る 場合に だ け使用 し て く だ さ
い。
接続 リ フ ァ レ ン ス
201
UseContextObject
UseContextObject を Yes に設定 し た場合、 SetTrans 関数を使用す る こ と
はで き ま せん。 SetTrans 関数は、 デー タ ウ ィ ン ド ウ エ ン ジ ン でデー タ
ベー ス 接続、 ト ラ ン ザ ク シ ョ ン 状態プ リ ミ テ ィ ブ、 お よ び関連す る
EAServer コ ン ポーネ ン ト の非活性化を管理す る 場合に使用 し ま す。
デ フ ォ ル ト の Web デー タ ウ ィ ン ド ウ コ ン ポーネ ン ト ではデー タ ベー
ス 接続情報を指定す る ために SetTrans を使用す る ので、 デー タ ベー ス
プ ロ フ ァ イ ル内、 ま たは コ ン ポーネ ン ト の EAServer プ ロ パテ ィ 内では
UseContextObject を Yes に設定 し ないで く だ さ い。
PowerBuilder を使用 し て EAServer コ ン ポーネ ン ト と MTS コ ン ポーネ
ン ト を作成す る 方法について は、 『ア プ リ ケーシ ョ ン テ ク ニ ッ ク 』 マ
ニ ュ アルを参照 し て く だ さ い。
例
TransactionServer コ ン テ キ ス ト オブ ジ ェ ク ト を使用す る には以下の よ
う に し ま す。
•
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ
ク ス の ［EAServer］ タ ブ ま たは ［EAServer/MTS］ タ ブの ［ ト ラ ン
ザ ク シ ョ ン オブジ ェ ク ト を使用］ チ ェ ッ ク ボ ッ ク ス を オ ン に し ま
す。
•
PowerBuilder ア プ リ ケーシ ョ ンのス ク リ プ ト
デー タ ベース プ ロ フ ァ イル
PowerBuilder
ケーシ ョ ン の ス ク リ プ ト で以下の入力を行い ま す。
アプ リ
SQLCA.dbParm = "UseContextObject = 'Yes'"
関連項目
202
CacheName
GetConnectionOption
ReleaseConnectionOption
PowerBuilder
第2章
第 2 章
デー タ ベース環境設定項目の解説
デー タ ベース環境設定項目の解説
この章について
こ の章では、 PowerBuilder におい て設定で き る 接続に関連 し たデー タ
ベース 環境設定項目の、 構文 と 使用方法について解説 し ま す。
内容
デー タ ベース 環境設定項目は、アル フ ァ ベ ッ ト 順に解説 さ れてい ま す。
デー タ ベース環境設定項目 と サポー ト さ れてい るデー タ
ベース イ ン タ フ ェ ース
次 の 表 に、 サ ポ ー ト さ れ て い る デ ー タ ベ ー ス イ ン タ フ ェ ー ス と 、
PowerBuilder で その イ ン タ フ ェ ー ス と 一緒に使用で き る 接続に関連 し
たデー タ ベー ス 環境設定項目を示 し ま す。 表に リ ス ト さ れてい る 環境
設定項目はデー タ ベース 接続に関す る も ので あ り 、 デー タ ベー ス ペ イ
ン タ の動作自体には関係あ り ま せん。
デー タ ベース イ ン タ フ ェ ース
IN9 Informix
JDBC
接続 リ フ ァ レ ン ス
デー タ ベース環境設定項目
AutoCommit
デ フ ォ ル ト のプ ロ フ ァ イ ルに接続
DB の接続 を保持
Lock
読み込みのみ
共有 DB プ ロ フ ァ イ ル
SQL 構文の終止符
拡張属性の使用
AutoCommit
デ フ ォ ル ト のプ ロ フ ァ イ ルに接続
DB の接続 を保持
Lock
読み込みのみ
共有 DB プ ロ フ ァ イ ル
SQL 構文の終止符
拡張属性の使用
203
デー タ ベース環境設定項目 と サポー ト さ れてい る デー タ ベース イ ン タ フ ェ ース
デー タ ベース イ ン タ フ ェ ース
MSS Microsoft SQL Server
ODBC
ODBC での AutoCommit と Lock
の使用
AutoCommit お よ び Lock デー タ
ベー ス環境設定項目は、 使用 し
て い る ODBC ド ラ イ バ と バ ッ
ク エ ン ド DBMS の 両 方 で サ
ポ ー ト さ れ て い る 場合にのみ
ODBC イ ン タ フ ェ ー ス に よ っ て
サポー ト さ れま す。
OLE DB
AutoCommit
デ フ ォ ル ト のプ ロ フ ァ イ ルに接続
DB の接続を保持
読み込みのみ
共有 DB プ ロ フ ァ イ ル
SQL 構文の終止符
拡張属性の使用
O73 Oracle 7.3
デ フ ォ ル ト のプ ロ フ ァ イ ルに接続
DB の接続を保持
読み込みのみ
共有 DB プ ロ フ ァ イ ル
SQL 構文の終止符
拡張属性の使用
AutoCommit
デ フ ォ ル ト のプ ロ フ ァ イ ルに接続
DB の接続を保持
Lock
読み込みのみ
共有 DB プ ロ フ ァ イ ル
SQL 構文の終止符
拡張属性の使用
および
O84 Oracle 8.x お よ び Oracle8i
および
O90 Oracle9i
SYC Sybase Adaptive Server
Enterprise
204
デー タ ベース環境設定項目
AutoCommit
デ フ ォ ル ト のプ ロ フ ァ イ ルに接続
DB の接続を保持
Lock
読み込みのみ
共有 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 に変更 を加
え て も 、 現行の接続にはその変更が反映 さ れ ま せん。
PowerBuilder ア プ リ ケーシ ョ ン ス ク リ プ ト の場合、AutoCommit の値は
いつで も リ セ ッ ト で き ま す。 こ のため、 必要に応 じ て初期設定を 変更
で き ま す。
対象
接続 リ フ ァ レ ン ス
IN9 Informix
JDB JDBC
MSS Microsoft SQL Server
ODBC（ ド ラ イ バお よ びバ ッ ク エ ン ド DBMS がサポー ト し てい る 場合）
OLE DB
SYC お よ び SYJ Sybase Adaptive Server Enterprise
205
AutoCommit
PowerBuilder ア プ リ
ケーシ ョ ンの場合
自動 コ ミ ッ ト を サポー ト し てい る 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 を発行 し て、 変更を元に戻 し ま す。 こ れに よ っ て、 デー タ
ベース におけ る デー タ の整合性 と セキ ュ リ テ ィ が保証 さ れ ま す。
206
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 プ ロ フ ァ イ ル設定 ダ イ ア ロ グボ ッ ク ス の ［接続］ タ
ブで、 ［自動 コ ミ ッ ト モー ド ］ チ ェ ッ ク ボ ッ ク ス を オ ン に し ま す。
開発環境
207
デ フ ォ ル ト のプ ロ フ ァ イルに接続
•
PowerBuilder ア プ リ ケーシ ョ ン ス ク リ プ ト
ス ク リ プ ト に次の よ う
に入力 し ま す。
SQLCA.AutoCommit = True
デー タ ベー ス
プ ロ フ ァ イ ルで ［自動 コ ミ ッ ト モー ド ］ を指定す る と 、 PowerScript 構
文が DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク ス の ［プ レ ビ ュ ー］ タ ブ
に表示 さ れ ま す。 そ の構文を ［プ レ ビ ュ ー］ タ ブか ら ス ク リ プ ト に コ
ピ ーで き ま す。
PowerBuilder ア プ リ ケーシ ョ ン ス ク リ プ ト での例の使用
デ フ ォル ト のプ ロ フ ァ イルに接続
機能
［デ フ ォ ル ト のプ ロ フ ァ イ ルに接続］ は、 デー タ ベー ス ペ イ ン タ が起
動 さ れた と き に、 それがデフ ォ ル ト のプ ロ フ ァ イ ル を使用 し てデー タ
ベー ス と の接続を確立す る か ど う か を制御 し ま す。 こ れが選択 さ れて
いない場合、 デー タ ベー ス と の接続を確立 し ないでデー タ ベース ペ イ
ン タ がオープ ン し ま す。
対象
すべてのデー タ ベース イ ン タ フ ェ ース
PowerBuilder ア プ リ
ケーシ ョ ンの場合
［デフ ォ ル ト のプ ロ フ ァ イ ルに接続］ 環境設定は、 PowerBuilder アプ リ
ケーシ ョ ン ス ク リ プ ト では設定で き ま せん。
開発環境の場合
デー タ ベース ペ イ ン タ で、 DB 環境設定 プ ロ パテ ィ シー ト の ［デフ ォ
ル ト のプ ロ フ ァ イ ルに接続］ チ ェ ッ ク ボ ッ ク ス を、 以下の よ う にオ ン
ま たはオ フ に し ま す。
デフ ォル ト 値
208
（デ フ ォ ル ト ） デー タ ベース ペ イ ン
タ を次に起動す る と き に、 自動的にデフ ォ ル ト のデー タ ベー ス プ
ロ フ ァ イ ルに接続 さ れ ま す。
•
チ ェ ッ ク ボ ッ ク ス を オ ン にする
•
チ ェ ッ ク ボ ッ ク ス を オ フ にする デー タ ベー ス ペ イ ン タ を 次に起動
す る と き に、 デフ ォ ル ト のデー タ ベース プ ロ フ ァ イ ルに自動的に
は接続 さ れ ま せん。
DB 環境設定 プ ロ パテ ィ シー ト の［デフ ォ ル ト のプ ロ フ ァ イ ルに接続］
チ ェ ッ ク ボ ッ ク ス は、 デフ ォ ル ト で選択 さ れてい ま す。
PowerBuilder
第2章
解説
デー タ ベース環境設定項目の解説
［デフ ォ ル ト のプ ロ フ ァ イ ルに接続］ では、 デー タ ベー ス と の接続を確
立 し な いででデー タ ベー ス ペ イ ン タ を オープ ン で き ま す。 そ のため、
デー タ ベー ス プ ロ フ ァ イ ルの定義お よ びデー タ ベー ス と の接続な ど
の、 デー タ ベー ス に関連す る すべての タ ス ク をデー タ ベース ペ イ ン タ
で実行で き ま す。 ただ し 、 デー タ ベース ペ イ ン タ を オープ ンす る と よ
り 多 く のシ ス テ ム リ ソ ー ス が使用 さ れ る ので、 プ ロ フ ァ イ ルの定義 と
デー タ ベー ス と の接続はデー タ ベー ス プ ロ フ ァ イ ル を 使用 し て行 っ
たほ う が よ いで し ょ う 。
DB の接続を保持
機能
デフ ォ ル ト では、 PowerBuilder は接続に必要なペ イ ン タ を最初にオー
プ ンす る 時に、 デー タ ベース 接続を オープ ン し て、 デー タ ベー ス を終
了す る ま でセ ッ シ ョ ン し てい る 間接続を保持 し ま す。
デー タ ベース プ ロ フ ァ イ ル を使用 し ないで、 PowerBuilder 開発環境で
デー タ ベース に接続す る 場合は、 デー タ ベース 環境設定の ［DB の接続
を保持］ を設定 し て、 PowerBuilder がデー タ ベー ス 接続を 終了す る 時
間 を指定で き ま す。
［DB の接続 を 保持］ は、 PowerBuilder 開発環境でデー タ ベー ス プ ロ
フ ァ イ ル を使用 し ないでデー タ ベー ス 接続をす る 場合にのみ適用で き
ま す。 ［DB の接続 を保持］ の設定は、 InfoMaker、 ま たはデー タ ベー
ス プ ロ フ ァ イ ルを使用 し て接続す る 場合には無効です。
対象
すべてのデー タ ベー ス イ ン タ フ ェー ス （PowerBuilder 開発環境のみ）
PowerBuilder ア プ リ
ケーシ ョ ンの場合
［DB の接続を保持］ 環境設定は、 PowerBuilder アプ リ ケーシ ョ ン ス ク
リ プ ト では設定で き ま せん。
開発環境の場合
デー タ ベース ペ イ ン タ で、 DB 環境設定 プ ロ パテ ィ シー ト の ［DB の
接続を保持］ チ ェ ッ ク ボ ッ ク ス を、 以下の よ う にオ ン ま たはオ フ に し
ま す。
デ フ ォル ト 値
接続 リ フ ァ レ ン ス
（デ フ ォ ル ト ） PowerBuilder セ ッ
シ ョ ン の間中デー タ ベー ス を接続 さ せて、 終了時に接続を解除 し
ま す。
•
チ ェ ッ ク ボ ッ ク ス を オ ン にする
•
チ ェ ッ ク ボ ッ ク ス を オ フ にする
ペ イ ン タ が 必要 な 時 にデー タ ベー
ス 接続 を オープ ン し て、 ペ イ ン タ の終了時か ス ク リ プ ト を コ ン パ
イ ルす る 時に接続を解除 し ま す。
DB 環境設定 プ ロ パテ ィ シー ト の ［DB の接続を保持］ チ ェ ッ ク ボ ッ ク
ス は、 デフ ォ ル ト でオ ンにな り ま す。
209
Lock
解説
［DB の接続を保持］ の使用のための要件 デ ー タ ベ ー ス 環 境 設 定 の
［DB の接続を保持］ を使用す る には、 以下の両方が True で あ る 必要が
あ り ま す。
PowerBuilder 開発環境で作業 を す
る 必要があ り ま す。 InfoMaker ではデー タ ベース 接続が ［開始時に
デ フ ォ ル ト のプ ロ フ ァ イ ルで接続］ 環境設定に よ っ て制御 さ れ る
ために、 ［DB の接続を保持］ の設定は無効です。
•
PowerBuilder 開発環境での作業
•
デ フ ォ ル ト 接続情報の使用 PowerBuilder は、 Windows レ ジ ス ト リ の
最近使っ た接続情報を 使っ て、 デー タ ベー ス に接続す る 必要があ
り ま す。 ［DB の接続を保持］ は、 デー タ ベース に接続す る デー タ
ベース プ ロ フ ァ イ ル を選択 し た場合は無効です。
設定後の処理 上記の要件を 満た し て い る 場合、 ［DB の接続 を保持］
チ ェ ッ ク ボ ッ ク ス を オ フ にす る と 、 接続に必要なペ イ ン タ で作業を し
てい る 場合にのみ、 デー タ ベース 接続がオープ ン にな り 、 それ以外の
場合は接続が解除 さ れ ま す。 こ の設定を行っ ておけば、 接続時間に応
じ て料金がかか る デー タ ベー ス へア ク セ ス し てい る 場合に、 費用を節
約で き ま す。
Lock
機能
値や分離 レ ベル を サ ポ ー ト す る DBMS お よ びデー タ ベー ス イ ン タ
フ ェ ー ス に対 し て、 デー タ ベース と 接続す る と き に、 使用す る 分離レ
ベル を設定 し ま す。
マルチユーザ デー タ ベー ス では、 異な る ユーザに よ っ て開始 さ れた ト
ラ ン ザ ク シ ョ ン がオーバ ラ ッ プす る こ と があ り ま す。 複数の ト ラ ン ザ
ク シ ョ ン がデー タ ベー ス 内の共用デー タ にア ク セ ス す る と 、 お互いに
上書 き し た り 、 衝突す る こ と があ り ま す。
DBMS に よ っ ては、 デー タ ベー ス と の接続時に分離 レベルを設定で き
ま す。 こ れは、 同時に実行 さ れ る ト ラ ン ザ ク シ ョ ン がお互いに干渉せ
ず、デー タ ベー ス の整合性を保つためです。分離 レベル（Isolation Level、
排他レベルな ど と も 呼ばれ ま す） は DBMS に よ っ て定義 さ れ、 あ る ト
ラ ン ザ ク シ ョ ン 内の処理が、 ほかの同時実行 ト ラ ンザ ク シ ョ ン の処理
に ど の よ う な 影響 を 及 ぼ す か を 指定 し ま す。 分離 レ ベ ル に よ っ て
DBMS デー タ にア ク セ ス す る 間、 ほかのプ ロ セ ス か ら ど の よ う に分離
さ れ る か、 つ ま り デー タ に対 し て ど の タ イ ミ ン グ で ロ ッ ク を か け る か
が決定 さ れ ま す。
210
PowerBuilder
第2章
デー タ ベース環境設定項目の解説
PowerBuilder では、 Lock 環境設定項目を使用 し て各種のデー タ ベー ス
ロ ッ ク オ プ シ ョ ン を設定で き ま す。 Lock 値は、 使用 し てい る DBMS
が定義す る 分離レベルに よ っ て異な り ま す。
Lock 値を指定する タ イ ミ ン グ
Lock 値は、 PowerBuilder の開発環境 ま た は PowerBuilder ア プ リ ケ ー
シ ョ ンにおいて、 デー タ ベー ス と 接続す る 前に設定す る 必要があ り ま
す。 Lock 値は、 デー タ ベース と の接続が発生 し た と き に限っ て有効 と
な り ま す。 接続後に Lock 値に変更を加え て も 、 現在の接続への影響は
あ り ま せん。
対象
IN9 Informix - OnLine デー タ ベー ス
JDB JDBC
MSS Microsoft SQL Server
ODBC（ ド ラ イ バお よ びバ ッ ク エ ン ド DBMS がサポー ト し てい る 場合）
SYC お よ び SYJ Sybase Adaptive Server Enterprise
PowerBuilder ア プ リ
ケーシ ョ ンの場合
Lock をサポー ト し てい る DBMS お よ びデー タ ベー ス イ ン タ フ ェ ー ス
の場合、 ト ラ ンザ ク シ ョ ン オブ ジ ェ ク ト のプ ロ パテ ィ と し て、 Lock 値
を ス ク リ プ ト の中で設定で き ま す。 以下の構文では、 デフ ォ ル ト の ト
ラ ンザ ク シ ョ ン オブジ ェ ク ト SQLCA を使用す る こ と が仮定 さ れてい
ま すが、 ユーザ定義の ト ラ ン ザ ク シ ョ ン オ ブ ジ ェ ク ト も 使用で き ま
す。
SQLCA.Lock = "value"
value は、 設定す る Lock 値です。
Lock 値
次の表に、 Lock を サポー ト す る デー タ ベー ス イ ン タ フ ェー ス の Lock
値 と 対応す る 分離 レ ベル を示 し ま す。 Lock 値は PowerBuilder ア プ リ
ケーシ ョ ン ス ク リ プ ト で、分離レベルはデー タ ベース プ ロ フ ァ イ ルで
設定 し ま す。
使用 し てい る DBMS がサポー ト す る 分離レ ベルについては、DBMS の
マ ニ ュ アルを参照 し て く だ さ い。
デー タ ベース イ ン
タ フ ェ ース
IN9 Informix
（OnLine デー タ ベー
ス専用）
接続 リ フ ァ レ ン ス
Lock 値
Dirty Read
分離レ ベル
Committed Read
（確定読み込み）
Cursor Stability
（カー ソ ル安定性）
Repeatable Read
（繰 り 返 し 読み込み）
（ダーテ ィ 読み出 し ）
211
Lock
デー タ ベース イ ン
タ フ ェ ース
JDB JDBC
Microsoft SQL Server
ODBC
OLE DB
Sybase Adaptive
Server Enterprise
Lock 値
RU
分離レ ベル
Read Uncommitted
RC
Read Committed
RR
Repeatable Read
TS
Serializable Transactions
TN
Transaction None
RU
Read Uncommitted
RC
Read Committed
RR
Repeatable Read
TS
Serializable
RU
Read Uncommitted
RC
Read Committed
RR
Repeatable Read
TS
Serializable Transactions
TV
Transaction Versioning
RU
Read Uncommitted
RC
Read Committed
RR
Repeatable Read
TS
TC
Serializable Transactions （デフ ォ
ルト）
Chaos
0
Read Uncommitted
1
Read Committed （デフ ォ ル ト ）
Serializable Transactions
3
開発環境の場合
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク ス の ［接続］ タ ブで、 ［分離レ
ベル］ ド ロ ッ プ ダ ウ ン リ ス ト の分離レベルを選択 し ま す。
詳細につい ては、 『デー タ ベー ス と の接続』 マ ニ ュ ア ルの 「接続パ ラ
メ ー タ の設定」 を参照 し て く だ さ い。
デフ ォル ト 値
デフ ォ ル ト の Lock 値は、 デー タ ベー ス の設定に よ っ て異な り ま す。 詳
細につい ては、 使用 し て い る DBMS の マ ニ ュ ア ル を 参照 し て く だ さ
い。
解説
Informix Informix に対す る Lock 値は、Informix-OnLine バージ ョ ン 9.x
のデー タ ベース に限っ て適用 さ れ ま す。 Informix-SE （Standard Edition）
デー タ ベース では、 Lock 値 と 分離レ ベルを使用で き ま せん。
212
PowerBuilder
第2章
デー タ ベース環境設定項目の解説
Microsoft SQL Server Microsoft SQL Server は、RR （Repeatable Read） 設
定 と TS （Serializable transaction） 設定を 同一に処理す る ため、 ど ち ら
の設定を選んで も 、 同 じ 結果が得 ら れ ま す。
ODBC TV （Transaction Versioning） 設定は、 Adaptive Server Anywhere
デー タ ベース には適用 さ れ ま せん。
Sybase Adaptive Server Enterprise Sybase Adaptive Server Enterprise は、
SQL Server の分離 レ ベルに対応 し て、 以下の Lock 値を サポー ト し ま
す。
•
分離レベル 0 は、コ ミ ッ
ト し ていない ト ラ ン ザ ク シ ョ ンが （UPDATE な ど の SQL 文で） 変
更 し たデー タ を、 別の ト ラ ン ザ ク シ ョ ン が変更す る こ と を禁止 し
ま す。
0 - Read Uncommitted （ダーテ ィ 読み出 し ）
最初の ト ラ ン ザ ク シ ョ ン が コ ミ ッ ト す る ま で、 別の ト ラ ン ザ ク
シ ョ ン がデー タ を変更で き ま せん。 し か し 、 コ ミ ッ ト し てい ない
デー タ で あ っ て も 、別の ト ラ ン ザ ク シ ョ ンが こ れを読み込み、ダー
テ ィ 読み出 し を実行す る こ と はで き ま す。 分離 レベル 0 は、 テー
ブルやページ上での検索 ロ ッ ク を禁止 し ま す。
分離 レベル 0 は、 Sybase System Version 10 以降のデー タ ベース に
限っ て有効です。
•
（デ フ ォ ル ト ） 分 離 レ ベ ル 1
は、 テーブルやページ上での共有 ロ ッ ク を発行す る こ と に よ っ て、
ダーテ ィ 読み出 し を禁止 し ま す。
1 - Read Committed （確定読み込み）
ダーテ ィ 読み出 し は、 あ る ト ラ ン ザ ク シ ョ ン がテーブルの行 を変
更 し ていて、 その変更が コ ミ ッ ト さ れ る 前に、 2 番目の ト ラ ン ザ ク
シ ョ ン がそ の行 を読み込む と き に発生 し ま す。 最初の ト ラ ン ザ ク
シ ョ ン が変更を ロ ールバ ッ ク す る と 、2 番目の ト ラ ンザ ク シ ョ ン が
読み込んだ情報は無効にな り ま す。
•
分離 レ ベル 3 は、
ト ラ ン ザ ク シ ョ ン の間のダーテ ィ 読み出 し 、 nonrepeatable read や
フ ァ ン ト ム値を禁止 し ま す。
3 - Serializable Transactions （HOLDLOCK 動作）
nonrepeatable read は、 あ る ト ラ ン ザ ク シ ョ ン が行を読み込み、 続
け て 2 番目の ト ラ ン ザ ク シ ョ ン がその行を変更す る と き に発生 し
ま す。 2 番目の ト ラ ン ザ ク シ ョ ン が変更を コ ミ ッ ト し た後で、 最初
の ト ラ ン ザ ク シ ョ ン が ま た読み込む と 、 最初の読み込み と 異な る
結果が得 ら れ ま す。
接続 リ フ ァ レ ン ス
213
Lock
フ ァ ン ト ム値は、 あ る ト ラ ン ザ ク シ ョ ン が検索条件 を満たす行の
セ ッ ト を 読み込み、 2 番目 の ト ラ ン ザ ク シ ョ ン が SQL INSERT、
UPDATE、 ま たは DELETE 文でそ のデー タ を変更す る と き に発生
し ま す。 最初の ト ラ ン ザ ク シ ョ ン が同 じ 検索条件で ま た読み込む
と 、 最初の読み込み と 異な る 行のセ ッ ト が得 ら れ ま す。
分離レベルの動的制御 Sybase Adaptive Server Enterprise デー タ ベース に
接続 し てい る 状態で、 PowerBuilder は 2 番目の接続 を し 、 以下のいず
れか を実装 し ま す。
•
デー タ ウ ィ ン ド ウ や レ ポー ト が、 必要な行だけ をデー タ ベー ス か
ら 取得す る よ う に指定す る Retrieve.AsNeeded プ ロ パテ ィ 。
•
指定 さ れた テーブル行の中で 1 つの blob カ ラ ム を選択す る
SELECTBLOB 埋め込み SQL 文。
Adaptive Server Enterprise に最初に接続す る 前に設定 し た ロ ッ ク 値は、2
番目の接続に も 自動的に継承 さ れ、 2 番目の接続用に変更で き ま せん。
し か し 、 PowerBuilder ア プ リ ケーシ ョ ン の中で、 次の 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"
CONNECT USING SQLCA;
// 1 番目の接続に限 り 、 ロ ッ ク 値 0 を上書 き
EXECUTE IMMEDIATE "set transaction isolation level 1";
例
Adaptive Server Anywhere デー タ ベー ス に対 し て、 Lock 値を RC
（Read Committed） に設定す る には以下の よ う に し ま す。
例1
•
開発環境 DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク ス で、 ［分離レ
ベル］ ド ロ ッ プダ ウ ン リ ス ト の 「Read Committed」 を選択 し ま す。
•
PowerBuilder ア プ リ ケーシ ョ ン ス ク リ プ ト
ス ク リ プ ト に次の よ う
に入力 し ま す。
SQLCA.Lock = "RC"
Sybase Adaptive Server Enterprise デー タ ベー ス に対 し て、 Lock 値
を 3 （Serializable Transactions） に設定す る には以下の よ う に し ま す。
例2
214
PowerBuilder
第2章
デー タ ベース環境設定項目の解説
•
開発環境 DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク ス で、 ［分離 レ
ベル］ ド ロ ッ プ ダ ウ ン リ ス ト の 「Serializable Transactions」 を選択
し ま す。
•
PowerBuilder ア プ リ ケーシ ョ ン ス ク リ プ ト
ス ク リ プ ト に次の よ う
に入力 し ま す。
SQLCA.Lock = "3"
デー タ ベー ス
プ ロ フ ァ イ ルで Isolation Level を指定す る と 、PowerScript 構文が DB プ
ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク ス の ［プ レ ビ ュ ー］ タ ブに表示 さ れ
ま す。 そ の構文を ［プ レ ビ ュ ー］ タ ブ か ら ス ク リ プ ト に コ ピ ーで き ま
す。
PowerBuilder ア プ リ ケーシ ョ ン ス ク リ プ ト での例の使用
読み込みのみ
機能
PowerBuilder が、 拡張属性シ ス テ ム テーブルや、 デー タ ベー ス内のほ
か の テ ーブ ル を 更新す る か ど う か を 指定 し ま す。 拡張属性 シ ス テ ム
テーブル （拡張カ タ ロ グ） は、 使用 し てい る デー タ ベー ス のデフ ォ ル
ト 拡張属性情報を含んだ 5 つのテーブルで構成 さ れてい ま す。
［読み込みのみ］ の設定は、 デー タ ベー ス 内のテーブル を変更 （更新）
で き る か ど う か を 決定 し ま す。 デフ ォ ル ト では、 DB 環境設定 プ ロ パ
テ ィ シー ト の ［読み込みのみ］ チ ェ ッ ク ボ ッ ク ス はオ フ にな っ てい ま
す。 つま り 、 拡張属性シ ス テ ム テーブルや、 デー タ ベース 内のほかの
テーブルは、 変更を加え る と 更新 さ れ ま す。
［読み込みのみ］ チ ェ ッ ク ボ ッ ク ス をオ ン にす る と 、PowerBuilder では、
拡張属性シ ス テ ム テーブルや、 デー タ ベース 内のほかのテーブルは更
新 さ れ ま せん。 ［読み込みのみ］ チ ェ ッ ク ボ ッ ク ス がオ ン の場合、 デー
タ ウ ィ ン ド ウ ま たは レ ポー ト ペ イ ン タ か ら 、拡張属性シ ス テ ム テーブ
ルな ど のデー タ ベー ス テーブルの情報を変更 （更新） で き ま せん。
対象
すべてのデー タ ベー ス イ ン タ フ ェー ス
PowerBuilder ア プ リ
ケーシ ョ ンの場合
PowerBuilder ア プ リ ケーシ ョ ン ス ク リ プ ト には、 読み込みのみのデー
タ ベー ス 環境設定項目を設定で き ま せん。
開発環境の場合
PowerBuilder のデー タ ベー ス ペ イ ン タ で、 DB 環境設定 プ ロ パ テ ィ
シー ト の ［読み込みのみ］ チ ェ ッ ク ボ ッ ク ス を オ ン ま たはオ フ に し ま
す。
接続 リ フ ァ レ ン ス
215
共有 DB プ ロ フ ァ イル
•
チ ェ ッ ク ボ ッ ク ス を オ ン にする デー タ ベー ス 内のテーブル （拡張属
性 シ ス テ ム テ ー ブ ル な ど） を 更新 し ま せ ん。 ［読み込み の み］
チ ェ ッ ク ボ ッ ク ス がオ ン の場合、 デー タ ウ ィ ン ド ウ ま たは レ ポー
ト ペ イ ン タ か ら 、 拡張属性シ ス テ ム テーブルな ど のデー タ ベー ス
テーブルの情報を変更 （更新） で き ま せん。
•
チ ェ ッ ク ボ ッ ク ス を オ フ にする
（デ フ ォ ル ト ） 拡 張 属 性 シ ス テ ム
テーブルな ど の、 デー タ ベー ス 内のテーブルに変更が加え ら れ る
と 、 更新 し ま す。
デフ ォル ト 値
DB 環境設定 プ ロ パテ ィ シー ト の ［読み込みのみ］ チ ェ ッ ク ボ ッ ク ス
は、 デフ ォ ル ト でオ フ に設定 さ れてい ま す。
解説
DB 環境設定 プ ロ パテ ィ シー ト の ［読み込みのみ］ チ ェ ッ ク ボ ッ ク ス
を オ ン にす る と 、 デー タ ウ ィ ン ド ウ ま たは レ ポー ト ペ イ ン タ か ら テー
ブル内の情報を変更す る こ と はで き ま せん。
こ のため、 以下を使用す る こ と がで き ま す。
関連項目
•
デー タ ウ ィ ン ド ウ ペ イ ン タ お よ びレ ポー ト ペ イ ン タ の SELECT
文 と Retrieve 文
•
埋め込み SQL の SELECT 文
拡張属性の使用
共有 DB プ ロ フ ァ イ ル
機能
共有 さ せたいデー タ ベース プ ロ フ ァ イ ル を含んだ PowerBuilder 初期設
定フ ァ イ ルのパ ス 名を指定 し ま す。
PowerBuilder 開発環境の共有デー タ ベース プ ロ フ ァ イ ルについての詳
細は、 『デー タ ベース と の接続』 マ ニ ュ アルの 「デー タ ベース 接続の管
理」 を参照 し て く だ さ い。
対象
すべてのデー タ ベース イ ン タ フ ェ ース
PowerBuilder ア プ リ
ケーシ ョ ンの場合
PowerBuilder ア プ リ ケーシ ョ ン ス ク リ プ ト では、 デー タ ベー ス 環境設
定で共有デー タ ベース プ ロ フ ァ イ ルを設定す る こ と はで き ま せん。
開発環境の場合
デー タ ベー ス ペ イ ン タ で、 DB 環境設定 プ ロ パテ ィ シー ト の ［共有
DB プ ロ フ ァ イ ル］ ボ ッ ク ス に共有 フ ァ イ ル を含んだ PowerBuilder 初
期設定フ ァ イ ルのパ ス 名を指定 し ま す。 パ ス 名は、直接入力ま たは ［参
照］ ボ タ ン を ク リ ッ ク し て、 表示で き ま す。
詳細につい ては、 『デー タ ベー ス と の接続』 マ ニ ュ ア ルの 「接続パ ラ
メ ー タ の設定」 を参照 し て く だ さ い。
216
PowerBuilder
第2章
デー タ ベース環境設定項目の解説
デ フ ォル ト 値
DB 環境設定 プ ロ パテ ィ シー ト の ［共有 DB プ ロ フ ァ イ ル］ ボ ッ ク ス
は、 デフ ォ ル ト では空白 （未指定） です。
例
Windows プ ラ ッ ト フ ォ ー ム 上の I:¥SHARE¥PB.INI に含 ま れ る デー タ
ベース プ ロ フ ァ イ ル を共有す る には、 DB 環境設定 プ ロ パテ ィ シー ト
の ［共有 DB プ ロ フ ァ イ ル］ ボ ッ ク ス に、 以下を入力す る か ［参照］ ボ
タ ン で表示 し ま す。
I:¥SHARE¥PB.INI
SQL 構文の終止符
機能
デー タ ベース ペ イ ン タ の対話型 SQL （ISQL） ビ ュ ーが使 う SQL 構文
の終止符を指定 し ま す。
ISQL ビ ュ ーのデフ ォ ル ト の終止符は、 セ ミ コ ロ ン （;） です。 セ ミ コ
ロ ンが DBMS 構文で使われてい る 終止符 と 衝突す る 場合は、 ペ イ ン タ
の終止符 を DB 環境設定 プ ロ パ テ ィ シー ト の ［SQL 構文の終止符］
ボ ッ ク ス で、 別の文字に指定す る こ と が で き ま す。 そ の際、 バ ッ ク
ク ォー ト 文字 （`） を選ぶ と よ いで し ょ う 。
ス ト ア ド プ ロ シージ ャ 、 ト リ ガ、 SQL ス ク リ プ ト を作成ま たは実行す
る ISQL ビ ュ ーを 使用 し てい る 場合には、 終止符を変更す る こ と をお
勧め し ま す。
対象
すべてのデー タ ベー ス イ ン タ フ ェー ス
PowerBuilder ア プ リ
ケーシ ョ ンの場合
PowerBuilder ア プ リ ケーシ ョ ン ス ク リ プ ト では、 デー タ ベー ス環境設
定で SQL 構文の終止符を設定す る こ と はで き ま せん。
開発環境の場合
デー タ ベース ペ イ ン タ の DB 環境設定 プ ロ パテ ィ シー ト で、 ［SQL 構
文の終止符］ ボ ッ ク ス に使用 し たい終止符を入力 し ま す。 詳細につい
て は、 『デー タ ベー ス と の接続』 マ ニ ュ ア ルの 「接続パ ラ メ ー タ の設
定」 を参照 し て く だ さ い。
デ フ ォル ト 値
DB 環境設定 プ ロ パテ ィ シー ト のデフ ォ ル ト の SQL 終止符の値は、セ
ミ コ ロ ン （;） です。
解説
以下は、 デフ ォ ル ト の SQL 終止符の値を変更す る 必要があ る 場合に行
う 一般的な処理です。
•
接続 リ フ ァ レ ン ス
ISQL ビ ュ ーで ス ト ア ド プ ロ
シージ ャ と ト リ ガ を作成 し てい る 場合、 ペ イ ン タ の終止符を バ ッ
ク ク ォ ー ト 文字 （`） の よ う な、 ス ト ア ド プ ロ シージ ャ ま たは ト リ
ガの DBMS 構文で使用 し ない文字に変更 し ま す。
ス ト ア ド プ ロ シ ージ ャ と ト リ ガの作成
217
拡張属性の使用
ス ト ア ド プ ロ シージ ャ を使用 し た後、 終止符を セ ミ コ ロ ン （;） に
変更で き ま す。新規の終止符を使用す る ほ う が都合が よ ければ、衝
突す る ス ト ア ド プ ロ シージ ャ ま たは ト リ ガ構文がない限 り 、 継続
し て使用で き ま す。
•
例
ISQL ビ ュ ーで SQL ス ク リ プ ト を実行す る
場合は、 ス ク リ プ ト で使用 さ れ る 終止符が、 現在ビ ュ ーで設定 さ
れてい る 終止符 と 一致 し てい る か ど う か確認 し て く だ さ い。
SQL ス ク リ プ ト の実行
ISQL ビ ュ ーの SQL 構文の終止符を バ ッ ク ク ォ ー ト （`） に戻すには、
DB 環境設定 プ ロ パテ ィ シー ト の ［SQL 構文の終止符］ ボ ッ ク ス に
バ ッ ク ク ォ ー ト を入力 し ま す。
拡張属性の使用
機能
PowerBuilder に拡張属性シ ス テ ム テーブル を作成 さ せ る か ど う か を指
定す る こ と で、 拡張属性シ ス テ ム テーブ ルへの ア ク セ ス を 制御 し ま
す。 拡張属性シ ス テ ム テーブル （拡張カ タ ロ グ） は、使用 し てい る デー
タ ベース のデフ ォ ル ト 拡張属性情報を含んだ 5 つのテーブルで構成 さ
れてい ま す。
デフ ォ ル ト では、DB 環境設定 プ ロ パテ ィ シー ト の ［拡張属性の使用］
チ ェ ッ ク ボ ッ ク ス は、 オ ン にな っ てい ま す。 オ ン にな っ てい る 場合は、
PowerBuilder を使 っ て最初にデー タ ベー ス に接続す る と き に、 拡張属
性シ ス テ ム テーブル を作成 し ま す。
対象
すべてのデー タ ベース イ ン タ フ ェ ース
PowerBuilder ア プ リ
ケーシ ョ ンの場合
PowerBuilder ア プ リ ケーシ ョ ン ス ク リ プ ト では、 デー タ ベー ス 環境設
定で ［拡張属性の使用］ を設定す る こ と はで き ま せん。
開発環境の場合
デー タ ベース ペ イ ン タ で、 DB 環境設定 プ ロ パテ ィ シー ト の ［拡張属
性の使用］ チ ェ ッ ク ボ ッ ク ス を オ ン ま たはオ フ に し ま す。
218
•
チ ェ ッ ク ボ ッ ク ス を オ ン にする （デ フ ォ ル ト ） 最初にデー タ ベー ス
に接続す る と き に、 拡張属性シ ス テ ム テーブル を作成 し ま す。
•
チ ェ ッ ク ボ ッ ク ス を オ フ にする 拡張属性シ ス テ ム テーブルが な い
場合は、 新規に作成 し ま せん。 そのかわ り に、 デー タ ウ ィ ン ド ウ と
レ ポー ト ペ イ ン タ が、拡張属性に対す る 適切なデフ ォ ル ト 値（ヘ ッ
ダ、 ラ ベル、 テ キ ス ト の色な ど ） を使用 し ま す。 拡張属性シ ス テ ム
テーブルがすでに あ る 場合は、 新規のデー タ ウ ィ ン ド ウ ま たは レ
ポー ト の作成時に、 PowerBuilder で拡張属性シ ス テ ム テーブルは
使用 さ れ ま せん。
PowerBuilder
第2章
デー タ ベース環境設定項目の解説
デ フ ォル ト 値
DB 環境設定 プ ロ パテ ィ シー ト の ［拡張属性の使用］ チ ェ ッ ク ボ ッ ク
ス は、 デフ ォ ル ト でオ ンにな っ てい ま す。
解説
DB 環境設定 プ ロ パテ ィ シー ト の ［拡張属性の使用］ チ ェ ッ ク ボ ッ ク
ス を オ フ に し た場合、 以下の作業はいずれ も 行われ ま せん。
関連項目
接続 リ フ ァ レ ン ス
•
拡張属性シ ス テ ム テーブルの作成
•
拡張属性シ ス テ ム テーブル内の行の挿入、 更新、 削除
•
拡張属性シ ス テ ム テーブルか ら の情報 （ヘ ッ ダ名な ど） の選択
•
拡張属性シ ス テ ム テーブルを参照す る 文の実行
読み込みのみ
219
デー タ ベース環境設定項目 と サポー ト さ れてい る デー タ ベース イ ン タ フ ェ ース
220
PowerBuilder
索引
A
CursorUpdate DBParm パ ラ メ ー タ
AppName DBParm パ ラ メ ー タ 6
Async DBParm パ ラ メ ー タ 7
AtAtIdentity DBParm パ ラ メ ー タ 9
AutoCommit デー タ ベー ス環境設定項目 205
AutoCommit ト ラ ン ザ ク シ ョ ン オブ ジ ェ ク ト プ ロ
パテ ィ 205
B
Block DBParm パ ラ メ ー タ
ODBC 11
OLE DB 11
Oracle 11
Sybase Adaptive Server Enterprise
Btrieve
DBParm パ ラ メ ー タ 1
13
C
CacheAuthentication DBParm パ ラ メ ー タ 14
CacheName DBParm パ ラ メ ー タ 15
CallEscaper DBParm パ ラ メ ー タ 16
CDB 値、 ODBC 接続文字列内 28
CharSet DBParm パ ラ メ ー タ 17
CnnPool DBParm パ ラ メ ー タ 18
CommitOnDisconnect DBParm パ ラ メ ー タ 20
ConnectAs DBParm パ ラ メ ー タ 21
ConnectOption DBParm パ ラ メ ー タ 22
ConnectString DBParm パ ラ メ ー タ 28
CursorLib DBParm パ ラ メ ー タ 30
CursorLock DBParm パ ラ メ ー タ
Microsoft SQL Server 32
ODBC 30
CursorScroll DBParm パ ラ メ ー タ
Microsoft SQL Server 35
ODBC 33
接続 リ フ ァ レ ン ス
38
D
DataLink DBParm パ ラ メ ー タ 39
Data Pipeline ペ イ ン タ
簡易エ ラ ー メ ッ セージの表示 110
行を一度に挿入 95
DataSource DBParm パ ラ メ ー タ 40
Date DBParm パ ラ メ ー タ 41
DateFormat DBParm パ ラ メ ー タ 44
DateTimeAllowed DBParm パ ラ メ ー タ 48
DateTime DBParm パ ラ メ ー タ 45
DateTimeFormat DBParm パ ラ メ ー タ 50
DateTime 型書式 45, 50
DateTime デー タ 型、 固有キー カ ラ ム 48
Date 型書式 41, 44
DB2、 DBParm パ ラ メ ー タ 1
DB2SYSPB.SQL ス ク リ プ ト 、 PBCatalogOwner
DBParm 127
DBA、 Adaptive Server Anywhere ス ト ア ド プ ロ シー
ジ ャ のオーナ 130
dBASE
DBParm パ ラ メ ー タ 1
デー タ ベー ス環境設定項目 203
DBGetTime DBParm パ ラ メ ー タ 51
DBMS
Lock 値 と 分離レ ベル 210
それぞれでサポー ト さ れてい る デー タ ベー ス環
境設定項目 203
それぞれでサポー ト さ れ る DBParm パ ラ メ ー タ
1
DBParm パ ラ メ ー タ
AppName 6
Async 7
AtAtIdentity 9
Block、 ODBC 11
Block、 OLE DB 11
221
索引
Block、 Oracle 11
Block、 Sybase Adaptive Server Enterprise
CacheAuthentication 14
CacheName 15
CallEscape 16
CharSet 17
CnnPool 18
CommitOnDisconnect 20
ConnectAs 21
ConnectOption 22
ConnectString 28
CursorLib 30
CursorLock、 Microsoft SQL Server 32
CursorLock、 ODBC 30
CursorScroll、 Microsoft SQL Server 35
CursorScroll、 ODBC 33
CursorUpdate 38
DataLink 39
DataSource 40
Date 41
DateFormat 44
DateTime 45
DateTimeAllowed 48
DateTimeFormat 50
DBGetTime 51
DBTextLimit 52
DecimalSeparator 53
DelimitIdentifier 55, 88
DisableBind 56, 96, 182
Driver 60
DS_Alias 61
DS_Copy 63
DS_DitBase 65
DS_Failover 69
DS_Password 71
DS_Principal 73
DS_Provider 75
DS_TimeLimit 78
EncryptPassword 79
FoDelay 80
FoDialog 81
FoRetryCount 82
FormatArgsAsExp 83
GetConnectionOption 85
Host 86
IdentifierQuoteCharacter 88
222
13
ImpersonationLevel 90
INET_DBPATH 91
INET_PROTOCOL 92
INET_SERVICE 93
Init_Prompt 94
InsertBlock 95
IntegratedSecurity 97
JavaVM 98
Language 100
LCID 101
Locale 102
Location 104
Log 104
LoginTimeOut 105
MaskPassword 106
MaxConnect 107
MixedCase 108
Mode 109
MsgTerse 110
NumbersInternal 111
NumericFormat 112
ObjectMode 115
OJSyntax 116
OptSelectBlob 118
OraMTSConFlgs 120
PackageProcs 122
PacketSize 124
PacketSize、 ODBC 123
PBCatalogOwner 126
PBMaxBlobSize 128
PBUseProcOwner 129
PersistEncrypted 131
PersistSecurityInfo 132
Properties 133
ProtectionLevel 134
Provider 135
ProviderString 137
ProxyUserName 138
PWDialog 139
PWEncrypt 141
QualifyPublic 142
Release 143
ReleaseConnectionOption 145
RPCRebind 146
Scroll 147
Sec_Channel_Bind 149
PowerBuilder
索引
Sec_Confidential 151
Sec_Cred_Timeout 153
Sec_Data_Origin 157
Sec_Delegation 158
Sec_Keytab_File 160
Sec_Mechanism 163
Sec_Mutual_Auth 165
Sec_Network_Auth 167
Sec_Replay_Detection 169
Sec_Seq_Detection 172
Sec_Server_Principal 174
Sec_Sess_Timeout 176
Secure 178
ServiceComponents 179
SQLCache 180
StaticBind 183
StripParmNames 185
SvrFailover 186
SystemProcs 188
TableCriteria 189
ThreadSafe 190
Time 192, 195
TimeOut 196
TraceFile 197
TrimSpaces 198
URL 199
UseContextObject 200
サポー ト さ れてい る デー タ ベー ス イ ン タ
フ ェース 1
DBTextLimit DBParm パ ラ メ ー タ 52
DB 環境設定 プ ロ パテ ィ シー ト の ［拡張属性の使
用］ チ ェ ッ ク ボ ッ ク ス 218
DB 環境設定 プ ロ パテ ィ シー ト の ［共有 DB プ ロ
フ ァ イ ル］ ボ ッ ク ス 216
DB 環境設定 プ ロ パテ ィ シー ト の ［デフ ォ ル ト の
プ ロ フ ァ イ ルに接続］ チ ェ ッ ク ボ ッ ク ス
208
DB 環境設定 プ ロ パテ ィ シー ト の ［読み込みの
み］ チ ェ ッ ク ボ ッ ク ス 215
［DB の接続 を保持］ のデー タ ベー ス環境設定
209
DB プ ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク ス
［自動 コ ミ ッ ト モー ド ］ チ ェ ッ ク ボ ッ ク ス
205
［分離 レベル］ ボ ッ ク ス 210
DDL 文、 SQL 206
接続 リ フ ァ レ ン ス
DecimalSeparator DBParm パ ラ メ ー タ 53
DelimitIdentifier DBParm パ ラ メ ー タ 55, 88
DisableBind DBParm パ ラ メ ー タ 56, 96, 182
Driver DBParm パ ラ メ ー タ 60
DS_Alias DBParm パ ラ メ ー タ 61
DS_Copy DBParm パ ラ メ ー タ 63
DS_DitBase DBParm パ ラ メ ー タ 65
DS_Failover DBParm パ ラ メ ー タ 69
DS_Password DBParm パ ラ メ ー タ 71
DS_Principal DBParm パ ラ メ ー タ 73
DS_Provider DBParm パ ラ メ ー タ 75
DS_TimeLimit DBParm パ ラ メ ー タ 78
DSN （デー タ ソ ース 名） 値、 ODBC 接続文字列内
28
E
EAServer 接続キ ャ ッ シ ュ
接続の解除 138
設定 15
EncryptPassword DBParm パ ラ メ ー タ
Excel ブ ッ ク
DBParm パ ラ メ ー タ 1
79
F
FoDelay DBParm パ ラ メ ー タ 80, 81
FoRetryCount DBParm パ ラ メ ー タ 82
FormatArgsAsExp DBParm パ ラ メ ー タ 83
G
GetConnectionOption DBParm パ ラ メ ー タ
85
H
Host DBParm パ ラ メ ー タ
86
223
索引
I
IBM Informix デー タ ベー ス イ ン タ フ ェ ー ス、
「Informix デー タ ベー ス イ ン タ フ ェ ー ス」 を参
照 203
IdentifierQuoteCharacter DBParm パ ラ メ ー タ 88
ImpersonationLevel DBParm パ ラ メ ー タ 90
INET_DBPATH DBParm パ ラ メ ー タ 91
INET_PROTOCOL DBParm パ ラ メ ー タ 92
INET_SERVICE DBParm パ ラ メ ー タ 93
Informix デー タ ベー ス イ ン タ フ ェ ース
DBParm パ ラ メ ー タ 1
INET_DBPATH DBParm パ ラ メ ー タ 91
INET_PROTOCOL DBParm パ ラ メ ー タ 92
INET_SERVICE DBParm パ ラ メ ー タ 93
Lock 値 と 分離 レベル 211
ThreadSafe DBParm パ ラ メ ー タ 190
カー ソ ル ス ク ロ ール オプシ ョ ン、 設定 147
小数点記号、 設定 53
デー タ ベー ス環境設定項目 203
Init_Prompt DBParm パ ラ メ ー タ 94
InsertBlock DBParm パ ラ メ ー タ 95
IntegratedSecurity DBParm パ ラ メ ー タ 97
INTERSOLV INFORMIX ODBC ド ラ イ バ （UNIX 上）
INET_DBPATH DBParm （使用不可） 91
INET_PROTOCOL DBParm （使用不可） 92
Scroll DBParm （対象外） 147
INTERSOLV ODBC ド ラ イ バ （UNIX）
INET_SERVICE DBParm （使用不可） 93
J
Jaguar CTS、 TransactionServer オブジ ェ ク ト の使用
200
Jaguar 接続キ ャ ッ シ ュ
オプシ ョ ン 85
接続の解除 145
Java VM、 指定 98
JavaVM DBParm パ ラ メ ー タ 98
JDBC デー タ ベー ス イ ン タ フ ェ ー ス
DateTime 型書式 45
Date 型書式 41
DBParm パ ラ メ ー タ 1
EAServer 接続キ ャ ッ シ ュ 、 接続の解除 138
224
EAServer 接続キ ャ ッ シ ュ 、 設定 15
Jaguar 接続キ ャ ッ シ ュ 、 オプシ ョ ン 85
Jaguar 接続キ ャ ッ シ ュ 、 接続の解除 145
Java VM、 指定 98
Lock 値 と 分離 レベル 211
Time 型書式 192, 195
TransactionServer オブジ ェ ク ト 、 使用 200
エ ラ ー メ ッ セージ、 簡略表示 110
数値書式、 設定 112
デー タ ベー ス URL、 設定 199
デー タ ベー ス環境設定項目 203
［テーブルの選択］ リ ス ト 、 変更 189
ド ラ イ バ名、 設定 60
ト レー ス、 設定 197
プ ロ パテ ィ 、 設定 133
ロ グ イ ン の タ イ ム ア ウ ト 、 設定 105
L
Language DBParm パ ラ メ ー タ 100
LCID DBParm パ ラ メ ー タ 101
Locale DBParm パ ラ メ ー タ 102
Location DBParm パ ラ メ ー タ 104
Lock Transaction オブ ジ ェ ク ト プ ロ パテ ィ
Lock 値 と 分離 レベル 210
ア プ リ ケーシ ョ ン での動的制御 214
Lock デー タ ベー ス環境設定 210
Log DBParm パ ラ メ ー タ 104
LoginTimeOut DBParm パ ラ メ ー タ 105
LOG フ ァ イ ル、 SQL Server 104
LUW 205
210
M
MaskPassword DBParm パ ラ メ ー タ 106
MaxConnect DBParm パ ラ メ ー タ 107
Microsoft SQL Server デー タ ベー ス イ ン タ フ ェ ー ス
DBParm パ ラ メ ー タ 1
IDENTITY カ ラ ム値の取得 9
Lock 値 と 分離 レベル 211
Secure DBParm パ ラ メ ー タ 178
ア プ リ ケーシ ョ ン名、 設定 6
PowerBuilder
索引
カー ソ ル ス ク ロ ール オプシ ョ ン、 設定 35
カー ソ ル ロ ッ ク オプシ ョ ン、 設定 32
言語、 設定 100
デー タ ベー ス環境設定項目 203
テ キ ス ト と イ メ ージの更新内容の記録 104
MixedCase DBParm パ ラ メ ー タ 108
Mode DBParm パ ラ メ ー タ 109
MsgTerse DBParm パ ラ メ ー タ 110
MTS
オプシ ョ ン 120
MTS、 TransactionServer オブジ ェ ク ト の使用
200
N
NumbersInternal DBParm パ ラ メ ー タ 111
NumericFormat DBParm パ ラ メ ー タ 112
O
ObjectMode DBParm パ ラ メ ー タ 115
ODBC イ ン タ フ ェ ー ス
ConnectOption DBParm、 使用 22
DateTime 型書式 45
Date 型書式 41
DBParm パ ラ メ ー タ 1
EAServer 接続キ ャ ッ シ ュ 、 接続の解除 138
EAServer 接続キ ャ ッ シ ュ 、 設定 15
Jaguar 接続キ ャ ッ シ ュ 、 オプシ ョ ン 85
Jaguar 接続キ ャ ッ シ ュ 、 接続の解除 145
Lock 値 と 分離 レベル 211
RPC、 再バ イ ン ド 146
Time 型書式 192, 195
TransactionServer オブジ ェ ク ト 、 使用 200
エ ラ ー メ ッ セージ、 簡略表示 110
カー ソ ル ス ク ロ ール オプシ ョ ン、 設定 33
カー ソ ル ブ ロ ッ ク フ ァ ク タ 、 設定 11
カー ソ ル ラ イ ブ ラ リ 、 設定 30
カー ソ ル ロ ッ ク オプシ ョ ン、 設定 30
小数点記号、 設定 53
数値書式、 設定 112
接続 リ フ ァ レ ン ス
接続文字列、 設定 28
デー タ パ イ プ ラ イ ン ペ イ ン タ での行の挿入
95
デー タ ベー ス環境設定項目 203
［テーブルの選択］ リ ス ト 、 変更 189
ネ ッ ト ワ ー ク パケ ッ ト サ イ ズ、 設定 123
パ ラ メ ー タ 名を取 る 185
ロ グ イ ン の タ イ ム ア ウ ト 、 設定 105
ODBC 接続文字列 28
ODBC デー タ ソ ー ス
ConnectString DBParm 内のデー タ ソ ー ス名
（DSN） 28
DateTime 型書式 45
Date 型書式 41
DBParm パ ラ メ ー タ 1
Lock 値 と 分離 レベル 211
RPC、 再バ イ ン ド 146
SQL 文のキ ャ ッ シ ュ 180
Time 型書式 192, 195
エ ラ ー メ ッ セージ、 簡略表示 110
カー ソ ル ス ク ロ ール オプシ ョ ン、 設定 33, 35
カー ソ ル ラ イ ブ ラ リ 、 設定 30
カー ソ ル ロ ッ ク オプシ ョ ン、 設定 30
接続文字列、 設定 28
デー タ パ イ プ ラ イ ン ペ イ ン タ での行の挿入
95
デー タ ベー ス環境設定項目 203
ネ ッ ト ワ ー ク パケ ッ ト サ イ ズ、 設定 123
ODBC デー タ ソ ー ス の再バ イ ン ド 146
ODBC ド ラ イ バ
DBParm パ ラ メ ー タ 1
Lock 値 と 分離 レベル 211
RPC、 再バ イ ン ド 146
SQL 文のキ ャ ッ シ ュ 180
エ ラ ー メ ッ セージ、 簡略表示 110
カー ソ ル ス ク ロ ール オプシ ョ ン、 設定 33
カー ソ ル ラ イ ブ ラ リ 、 設定 30
カー ソ ル ロ ッ ク オプシ ョ ン、 設定 30
数値書式、 設定 112
接続文字列、 設定 28
デー タ ベー ス環境設定項目 203
ネ ッ ト ワ ー ク パケ ッ ト サ イ ズ、 設定 123
225
索引
ロ グ イ ン の タ イ ム ア ウ ト 、 設定 105
ODBC ド ラ イ バ マネージ ャ ト レ ー ス、 ConnectOption
DBParm に よ る 設定 22
ODBC の ス ト ア ド プ ロ シージ ャ 、 オーナ名の修飾
129
OJSyntax DBParm パ ラ メ ー タ 116
OLE DB デー タ ベー ス イ ン タ フ ェ ース
blob の最大サ イ ズ、 指定 128
DateTime 型書式 50
Date 型書式 44
DBParm パ ラ メ ー タ 1
Lock 値 と 分離 レベル 211
SQL Server デー タ ベー ス、 指定 137
ア ク セ ス パー ミ ッ シ ョ ン 109
暗号化パ ス ワ ー ド の保存 131
イ ン パー ソ ネーシ ョ ン レベル 90
カー ソ ル ブ ロ ッ ク フ ァ ク タ 、 設定 11
タ イ ム ア ウ ト 、 設定 196
デー タ ソ ース 、 指定 40
デー タ プ ロ バ イ ダ、 指定 135
デー タ ベー ス環境設定項目 203
デー タ ベー ス サーバ名、 識別 104
デー タ 保護 レベル、 指定 134
デー タ リ ン ク フ ァ イ ル、 使用 39
認証サービ ス、 指定 97
認証情報の キ ャ ッ シ ュ 14
認証情報の保存 132
パ ス ワ ー ド の暗号化 79, 80
パ ス ワ ー ド のマ ス ク 化 106
プ ロ ン プ ト 、 設定 94
ロ ケール識別子、 設定 101
OptSelectBlob DBParm パ ラ メ ー タ 118
Oracle デー タ ベー ス イ ン タ フ ェ ー ス
DateTime 型書式 45
Date 型書式 41
DBParm パ ラ メ ー タ 1
EAServer 接続キ ャ ッ シ ュ 、 設定 15
Jaguar 接続キ ャ ッ シ ュ 、 オプシ ョ ン 85
Jaguar 接続キ ャ ッ シ ュ 、 接続の解除 145
MTS コ ン ポーネ ン ト 、 オプシ ョ ン 120
NumbersInternal DBParm パ ラ メ ー タ 111
Oracle の内部数値書式の使用 111
PackageProcs DBParm パ ラ メ ー タ 122
226
PUBLIC 修飾子の使用 142
QualifyPublic DBParm パ ラ メ ー タ 142
SQL 文のキ ャ ッ シ ュ 180
ThreadSafe DBParm パ ラ メ ー タ 190
Time 型書式 192, 195
TransactionServer オブジ ェ ク ト 、 使用 200
大文字 と 小文字の区別、 設定 108
オブジ ェ ク ト モー ド 115
カー ソ ル ブ ロ ッ ク フ ァ ク タ 、 設定 11
小数点記号、 設定 53
デー タ ベー ス環境設定項目 203
［テーブルの選択］ リ ス ト 、 変更 189
パ ス ワ ー ド が期限切れです ダ イ ア ロ グ ボ ッ ク
ス、 表示 139
パ ッ ケージ オブジ ェ ク ト の一覧表示 122
フ ェ イ ルオーバ 81, 82, 186
OraMTSConFlgs DBParm パ ラ メ ー タ 120
P
PackageProcs DBParm パ ラ メ ー タ 122
Packet Size DBParm パ ラ メ ー タ 124
ODBC で使用 123
Paradox 5
DBParm パ ラ メ ー タ 1
PBCatalogOwner DBParm パ ラ メ ー タ 126
PBMaxBlobSize DBParm パ ラ メ ー タ 128
PBUseProcOwner DBParm パ ラ メ ー タ 129
PersistEncrypted DBParm パ ラ メ ー タ 131
PersistSecurityInfo DBParm パ ラ メ ー タ 132
Properties DBParm パ ラ メ ー タ 133
ProtectionLevel DBParm パ ラ メ ー タ 134
Provider DBParm パ ラ メ ー タ 135
ProviderString DBParm パ ラ メ ー タ 137
ProxyUserName DBParm パ ラ メ ー タ 138
PWDialog DBParm パ ラ メ ー タ 139
PWD （パ ス ワー ド ） 値、 ODBC 接続文字列内
PWEncrypt DBParm パ ラ メ ー タ 141
28
Q
QualifyPublic DBParm パ ラ メ ー タ
142
PowerBuilder
索引
R
ReleaseConnectionOption DBParm パ ラ メ ー タ
145
Release DBParm パ ラ メ ー タ 143
RetrieveRow イ ベン ト 、 非同期処理の記述 7
RPCRebind DBParm パ ラ メ ー タ 146
S
Scroll DBParm パ ラ メ ー タ 147
Sec_Channel_Bind DBParm パ ラ メ ー タ 149
Sec_Confidential DBParm パ ラ メ ー タ 151
Sec_Cred_Timeout DBParm パ ラ メ ー タ 153
Sec_Data_Origin DBParm パ ラ メ ー タ 157
Sec_Delegation DBParm パ ラ メ ー タ 158
Sec_Keytab_File DBParm パ ラ メ ー タ 160
Sec_Mechanism DBParm パ ラ メ ー タ 163
Sec_Mutual_Auth DBParm パ ラ メ ー タ 165
Sec_Network_Auth DBParm パ ラ メ ー タ 167
Sec_Replay_Detection DBParm パ ラ メ ー タ 169
Sec_Seq_Detection DBParm パ ラ メ ー タ 172
Sec_Server_Principal DBParm パ ラ メ ー タ 174
Sec_Sess_Timeout DBParm パ ラ メ ー タ 176
Secure DBParm パ ラ メ ー タ 178
ServiceComponents DBParm パ ラ メ ー タ 179
SQLCache DBParm パ ラ メ ー タ 180
SQLSTATE エ ラ ー プ レ フ ィ ク ス、 表示の抑制
110
SQL 構文の終止符、 デー タ ベー ス ペ イ ン タ での
変更 217
［SQL 構文の終止符］ のデー タ ベー ス環境設定項
目 217
SQL デー タ 定義言語 （DDL） 文 206
SQL フ ァ イ ル、 DB2SYSPB.SQL 127
SQL 文
キ ャ ッ シ ュ 57, 180
固有キー カ ラ ム と し て DateTime カ ラ ム を許可
48
テーブル と カ ラ ム の区切 り 88
ト ラ ンザ ク シ ョ ン の内側か外側で発行 205
バ イ ン ド 変数 56
SQL 文のキ ャ ッ シ ュ
概要 180
StaticBind DBParm パ ラ メ ー タ 183
接続 リ フ ァ レ ン ス
StripParmNames DBParm パ ラ メ ー タ 185
SvrFailover DBParm パ ラ メ ー タ 186
Sybase Adaptive Server Anywhere
DBA、 ス ト ア ド プ ロ シージ ャ のオーナ 130
DBParm パ ラ メ ー タ 1
ス ト ア ド プ ロ シージ ャ 、 オーナ名での修飾
130
デー タ ベー ス環境設定項目 203
Sybase Adaptive Server Enterprise デー タ ベー ス イ ン
タ フ ェース
DBParm パ ラ メ ー タ 1
EAServer 接続キ ャ ッ シ ュ 、 接続の解除 138
EAServer 接続キ ャ ッ シ ュ 、 設定 15
Jaguar 接続キ ャ ッ シ ュ 、 オプシ ョ ン 85
Jaguar 接続キ ャ ッ シ ュ 、 接続の解除 145
Lock 値 と 分離 レベル 211
TransactionServer オブジ ェ ク ト 、 使用 200
ア プ リ ケーシ ョ ン名、 設定 6
カー ソ ルの宣言 38
カー ソ ル ブ ロ ッ ク フ ァ ク タ 、 設定 13
言語、 設定 100
セキ ュ リ テ ィ サービ ス の DBParm パ ラ メ ー タ
149
デ ィ レ ク ト リ サービ ス の DBParm パ ラ メ ー タ
61
デー タ ベー ス環境設定項目 203
［テーブルの選択］ リ ス ト 、 変更 189
テ キ ス ト と イ メ ージの更新内容の記録 104
パ ス ワ ー ド が期限切れです ダ イ ア ロ グ ボ ッ ク
ス、 表示 139
パ ス ワ ー ド の暗号化 141
フ ェ イ ルオーバ 186
分離レ ベル、 ア プ リ ケーシ ョ ン での動的制御
214
文字セ ッ ト 、 設定 17
リ リ ー ス、 設定 143
ロ ケール、 設定 102
Sybase Adaptive Server Enterprise の UNIX 上での分
散アプ リ ケーシ ョ ン イ ン タ フ ェ ー ス
DBParm パ ラ メ ー タ 1
Sybase Open Client セ キ ュ リ テ ィ サービ ス
Release DBParm パ ラ メ ー タ 143
Sec_Channel_Bind DBParm パ ラ メ ー タ 149
227
索引
Sec_Confidential DBParm パ ラ メ ー タ 151
Sec_Cred_Timeout DBParm パ ラ メ ー タ 153
Sec_Data_Integrity DBParm パ ラ メ ー タ 155
Sec_Data_Origin DBParm パ ラ メ ー タ 157
Sec_Delegation DBParm パ ラ メ ー タ 158
Sec_Keytab_File DBParm パ ラ メ ー タ 160
Sec_Mechanism DBParm パ ラ メ ー タ 163
Sec_Mutual_Auth DBParm パ ラ メ ー タ 165
Sec_Network_Auth DBParm パ ラ メ ー タ 167
Sec_Replay_Detection DBParm パ ラ メ ー タ 169
Sec_Seq_Detection DBParm パ ラ メ ー タ 172
Sec_Server_Principal DBParm パ ラ メ ー タ 174
Sec_Sess_Timeout DBParm パ ラ メ ー タ 176
Sybase Open Client デ ィ レ ク ト リ サービ ス
DS_Alias DBParm パ ラ メ ー タ 61
DS_Copy DBParm パ ラ メ ー タ 63
DS_DitBase DBParm パ ラ メ ー タ 65
DS_Failover DBParm パ ラ メ ー タ 69
DS_Principal DBParm パ ラ メ ー タ 71, 73
DS_Provider DBParm パ ラ メ ー タ 75
DS_TimeLimit DBParm パ ラ メ ー タ 78
Release DBParm パ ラ メ ー タ 143
サー ド パーテ ィ のデ ィ レ ク ト リ サー ビ ス プ ロ バ イ
ダ 75
Sybase Open Client デ ィ レ ク ト リ サービ ス の DIT ベー
ス
例 67
SYSIBM、 DB2 テーブル オーナの名前 と し ては使用で
き ない 127
SystemProcs DBParm パ ラ メ ー タ 188
T
TableCriteria DBParm パ ラ メ ー タ 189
ThreadSafe DBParm パ ラ メ ー タ 190
Time DBParm パ ラ メ ー タ 192, 195
TimeOut DBParm パ ラ メ ー タ 196
Time 型書式 192, 195
TraceFile DBParm パ ラ メ ー タ 197
TransactionServer オブジ ェ ク ト 、 使用 200
TrimSpaces DBParm パ ラ メ ー タ 198
228
U
UID （ユーザ ID） 値、 ODBC 接続文字列内
URL、 JDBC 内での使用 199
URL DBParm パ ラ メ ー タ 199
UseContextObject DBParm パ ラ メ ー タ 200
28
い
イ ンデ ッ ク ス
名前の区切 り 記号 88
名前を二重引用符で囲む
55
え
エ ラ ー メ ッ セージ、 簡略表示
110
お
大文字 と 小文字の区別、 Oracle デー タ ベー ス
108
か
カー ソ ル
ConnectOption DBParm パ ラ メ ー タ での設定 22
insensitive、 Microsoft SQL Server 35
キーセ ッ ト 駆動、 ODBC 33
キーセ ッ ト 駆動、 Microsoft SQL Server 35
更新特性 38
混成、 Microsoft SQL Server 35
混成、 ODBC 33
ス ク ロ ール オプシ ョ ン、 Informix イ ン タ フ ェ ー
ス 147
ス ク ロ ール オプシ ョ ン、 Microsoft SQL Server
35
ス ク ロ ール オプシ ョ ン、 ODBC 33
ブ ロ ッ ク フ ァ ク タ 11
ブ ロ ッ ク フ ァ ク タ 、 Sybase Adaptive Server
Enterprise 13
ラ イ ブ ラ リ 、 ODBC 30
PowerBuilder
索引
ロ ッ ク オプシ ョ ン、 Microsoft SQL Server 32
ロ ッ ク オプシ ョ ン、 ODBC 30
拡張属性シ ス テ ム テーブル
［拡張属性の使用］ のデー タ ベー ス環境設定項
目に よ る作成の制御 218
テーブル オーナ、 設定 126
拡張属性シ ス テ ム テーブル、 ［読み込みのみ］
デー タ ベー ス環境設定項目に よ る 更新の
制御 215
［拡張属性の使用］ のデー タ ベー ス環境設定項目
218
カ ッ コ （右）、 SQL 構文の終止符 217
カラム
DateTime デー タ 型 48
デ フ ォ ル ト 値 と バ イ ン ド 変数 58
名前の区切 り 記号 88
名前を二重引用符で囲む 55
き
キーセ ッ ト 駆動カー ソ ル
Microsoft SQL Server 35
ODBC 33
キ ャ ッ シ ュ 、 バ イ ン ド 変数 と SQL 文 57
キ ャ ッ シ ュ 、 バ イ ン ド 変数 と SQL 文 181, 182
［共有 DB プ ロ フ ァ イ ル］ のデー タ ベー ス環境設
定項目 216
共有デー タ ベー ス プ ロ フ ァ イ ル、 セ ッ ト ア ッ プ
216
さ
最適化同時実行制御
31, 32
し
指数表記、 検索引数 83
［自動 コ ミ ッ ト モー ド ］ チ ェ ッ ク ボ ッ ク ス、 DB プ
ロ フ ァ イ ル設定 ダ イ ア ロ グ ボ ッ ク ス 205
小数点記号
DecimalSeparator DBParm での設定 53
NumericFormat DBParm を使用 し た設定 114
す
ス ク ロ ール オプシ ョ ン、 カー ソ ル
Informix イ ン タ フ ェ ー ス 147
Microsoft SQL Server 35
ODBC 33
ス ト ア ド プ ロ シージ ャ 、 Adaptive Server Enterprise、
表示 188
ス ト ア ド プ ロ シージ ャ 、 Oracle
SQL 構文の終止符の変更 217
ス ト ア ド プ ロ シージ ャ 、 SQL Server
お よ び AutoCommit 206
表示 188
せ
け
結果セ ッ ト 、 検索前の情報の取得
検索、 非記述 183
検索引数、 指数表記 83
こ
混成カー ソ ル
Microsoft SQL Server
ODBC 33
接続 リ フ ァ レ ン ス
183
セキ ュ リ テ ィ
ConnectOption DBParm での設定 22
Microsoft SQL Server 179
接続文字列、 ODBC 28
セ ミ コ ロ ン、 SQL 構文のデフ ォ ル ト の終止符
217
た
35
ダーテ ィ 読み出 し
213
229
索引
て
デー タ ウ ィ ン ド ウ オブジ ェ ク ト
検索前の結果セ ッ ト 情報の取得 183
非同期処理 7
デー タ ソ ー ス、 OLE DB 内での指定 40
デー タ 定義言語 （DDL） 文、 SQL 206
デー タ ベー ス
Lock 値 と 分離 レベル 210
更新の制御 215
接続の保持 209
デー タ ベー ス イ ン タ フ ェ ー ス
DBParm パ ラ メ ー タ 1
デー タ ベー ス環境設定項目 203
デー タ ベー ス環境設定項目
AutoCommit 205
DB の接続を保持 209
SQL 構文の終止符 217
拡張属性の使用 218
共有 DB プ ロ フ ァ イ ル 216
サポー ト さ れてい る デー タ ベー ス イ ン タ フ ェ ース
203
デ フ ォ ル ト のプ ロ フ ァ イ ルに接続 208
読み込みのみ 215
ロ ッ ク 210
デー タ ベー ス の更新、 制御 215
デー タ ベー ス プ ロ フ ァ イ ル
ODBC デー タ ソ ー ス の接続文字列 28
［共有 DB プ ロ フ ァ イ ル］ のデー タ ベー ス環境設定
項目のセ ッ ト ア ッ プ 216
接続プール 18
デー タ ベー ス ペ イ ン タ 、 SQL 構文の終止符の変更
217
デー タ ベー スへの接続、 接続の保持 209
デー タ リ ン ク フ ァ イ ル、 OLE DB 内での使用 39
テーブル
更新の制御 215
［テーブルの選択］ リ ス ト 、 変更 189
名前の区切 り 記号 88
名前を二重引用符で囲む 55
［テーブルの選択］ リ ス ト 、 変更 189
テキ ス ト フ ァ イル
DBParm パ ラ メ ー タ 1
デー タ ベー ス環境設定項目 203
230
［デフ ォ ル ト のプ ロ フ ァ イ ルに接続］ のデー タ ベー
ス環境設定 208
と
同時実行制御、 最適化 31, 32
ト ラ ンザ ク シ ョ ン
SQL 文 を内部か外部で発行 205
ロ ッ ク と 分離レ ベル 210
ト ラ ンザ ク シ ョ ン ロ グ、 SQL Server
104
に
認証サービ ス、 OLE DB デー タ ベー ス での指定
97
認証情報、 OLE DB デー タ ベー スへの保存 132
は
バ イ ン ド 変数
SQL 文内での使用 57
キ ャ ッ シ ュ SQL 文 57
キ ャ ッ シ ュ さ れた SQL 文 182
デ フ ォ ル ト のカ ラ ム値 58
デ フ ォ ル ト バ イ ン ド の無効化 56
パケ ッ ト サ イ ズ、 ネ ッ ト ワ ー ク
ODBC デー タ ソ ー ス の設定 123
設定 124
パス ワー ド
ConnectString DBParm 内 28
OLE DB デー タ ベー ス でのマ ス ク 化 106
OLE DB デー タ ベー ス に暗号化 し て保存 131
OLE DB デー タ ベー ス の暗号化 79
Sybase Adaptive Server Enterprise デー タ ベー ス で
の暗号化 141
バ ッ ク ク ォ ー ト 文字 （`）、 SQL 構文の終止符
217
反復不能読み込み 213
PowerBuilder
索引
ひ
非記述検索 183
非同期処理、 有効化
反復不能読み込み 213
フ ァ ン ト ム値 213
論理的な作業単位 （LUW） 205
7
ふ
フ ァ ン ト ム値 213
フ ェ イ ルオーバ
Oracle デー タ ベー ス での使用 81, 82
フ ェ イ ルオーバ、 Oracle デー タ ベー ス での使用
80
ブ ロ ッ ク フ ァ ク タ 、 カー ソ ルに対す る 設定 11,
13
分離レ ベル と Lock 値 210
ア プ リ ケーシ ョ ン での動的制御 214
［分離 レベル］ ボ ッ ク ス、 DB プ ロ フ ァ イ ル設定
ダ イ ア ロ グ ボ ッ ク ス 210
も
文字セ ッ ト 、 設定
17
ゆ
ユーザ ID、 ConnectString DBParm 内
28
よ
読み込み、 ダーテ ィ お よ び反復不能 213
［読み込みのみ］ デー タ ベー ス環境設定 215
ろ
ロック
DBMS 分離 レベル 210
ア プ リ ケーシ ョ ン での分離レ ベルの動的制御
214
カー ソ ル、 Microsoft SQL Server 32
カー ソ ル、 ODBC 30
ダーテ ィ 読み出 し 213
接続 リ フ ァ レ ン ス
231
索引
232
PowerBuilder

PowerBuilder/InfoMaker OS対応表

業務経歴 - e-sato

ダウンロード - 株式会社サイバー・ソリューションズ

のお知らせ - 新百合山手アクザワ歯科

ダウンロード - 株式会社ジー・イー・エヌ（GEN）

新機能 PowerBuilder 12.0

「株式会社リクルート キーマンズネット 06年1月18日掲載 Keyレポ より

大阪大学サイバーメディアセンターとマイクロソフトが ITを活用した

PowerBuilder 11.5 新機能