@@ -21,7 +21,7 @@ Oracle Database and explain use-cases to be considered while choosing the
2121connection management strategy. The section below provides more details on
2222specific connection management strategy.
2323
24- ============================================================================
24+ ----
2525## InternalT2Driver.sql & InternalT2Driver.java:
2626The server-side Type 2 (T2S) driver (aka KPRB driver) is for Java in the
2727database. It uses database session directly for accessing local data.
@@ -49,65 +49,12 @@ the user being proxied for.
4949(c) CERTIFICATE: More encrypted way of passing the credentials of the user,
5050 who is to be proxied, to the database.
5151
52- ## UCPSample.java:
53- Universal Connection Pool (UCP) is a client side connection pool. UCP
54- furnishes a rich set of features to support scalability in single database
55- instance as well as built-in features to support high-availability and
56- scalability in RAC and Active Data Guard environments. UCP along with RAC,
57- RAC One and ADG is a tested and certified combination for handling database
58- failovers. Refer to this sample for using UCP and setting UCP properties
59- such as ` minPoolSize ` , ` maxPoolSize ` , etc.
60-
61- ## UCPWithTimeoutProperties.java:
62- UCP furnishes a set of TimeOut properties which can be used to tune
63- performance. The sample demonstrates using some of UCP's important Timeout
64- properties, such as ` InactivityTimeout ` , ` AbandonedConnectionTimeout ` ,
65- ` TimeToLiveTimeout ` , and ` connectionWaitTimeout ` . Each one of the UCP timeout
66- property can be run independently. Refer to the sample for more details.
67-
68- ## UCPWebSessionAffinitySample.java:
69- Web-Session Affinity is a scalability feature of UCP in RAC and Active Data
70- Guard environment which attempts to allocate connections from the same RAC
71- instance during the life of a Web application. UCP tries to do a best try
72- effort, but, there is no guarantee to get a connection to the same instance.
73- UCP Web-Session Affinity is used in applications which expect short lived
74- connections to any database instance.
75-
76- ## UCPConnectionLabelingSample.java:
77- Connection Labelling allows applications to set custom states ("labels")
78- then retrieve connections based on these pre-set states thereby avoiding the
79- cost of resetting these states. The sample uses ` applyConnectionLabel() ` to
80- apply a connection label and retrieves a connection using ` getConnection(label) `
81- by specifying the created label.
82-
83- ## UCPConnectionHarvestingSample.java:
84- UCP's Connection Harvesting allows UCP to pro-actively reclaim borrowed
85- connections based on pool requirements at run-time, while still giving
86- applications control over which borrowed connections should not be reclaimed.
87- The sample uses ` registerConnectionHarvestingCallback ` to register a connection
88- harvesting callback.
89-
90- ## UCPWithDRCPSample.java:
91- Database Resident Connection Pool (DRCP) is the server side connection pool.
92- DRCP should be used in a scenario when there are a number of middle tiers but
93- the number of active connections is fairly less than the number of open
94- connections.
95- DRCP when used along with and Universal Connection Pool(UCP) as the client
96- side connection pool improves the performance. The sample shows UCP with DRCP
97- in action. The purpose of the client-side pooling mechanism is to maintain the
98- connections to Connection Broker. Client-side connection pools must attach and
99- detach connections to the connection broker through ` attachServerConnection() `
100- and ` detachServerConnection() ` . DRCP should be used in a scenario when there are
101- a number of middle tiers but the number of active connections is fairly less
102- than the number of open connections.
103-
10452## DRCPSample.java:
10553DRCP can be used with or without a client side connection pool.
10654Either UCP or any other third party connection pool (eg., C3P0) can be used as
10755client side pool. Note that, when UCP is used, it takes care of attaching and
10856releasing server connections. There is no need to explicitly call
10957` attachServerConnection() ` /` detachServerConnection() ` with UCP.
11058
111- ============================================================================
112-
59+ ----
11360
0 commit comments