@@ -4234,3 +4234,54 @@ See :ref:`exception` for usage information.
4234
4234
Boolean attribute representing whether the error is recoverable or not.
4235
4235
This is False in all cases unless both Oracle Database 12.1 (or later) and
4236
4236
Oracle Client 12.1 (or later) are being used.
4237
+
4238
+ .. _oracledbplugins :
4239
+
4240
+ Oracledb Plugins
4241
+ ================
4242
+
4243
+ The `namespace package <https://packaging.python.org/en/latest/guides/
4244
+ packaging-namespace-packages/#native-namespace-packages> `__
4245
+ ``oracledb.plugins `` can contain plugins to extend the capability of
4246
+ python-oracledb. See :ref: `customplugins `. Note that the namespace
4247
+ ``oracledb.plugins.ldap_support `` is reserved for future use by the
4248
+ python-oracledb project.
4249
+
4250
+ .. versionadded :: 3.0.0
4251
+
4252
+ .. _configociplugin :
4253
+
4254
+ Oracle Cloud Infrastructure (OCI) Object Storage Configuration Provider Plugin
4255
+ ------------------------------------------------------------------------------
4256
+
4257
+ ``oracledb.plugins.oci_config_provider `` is a plugin that provides access to
4258
+ the configuration information stored in the :ref: `OCI Object Storage
4259
+ <ociobjstorage>` configuration provider. Importing this plugin defines and
4260
+ :meth: `registers <oracledb.register_protocol()> ` the hook function that
4261
+ handles :ref: `OCI Object Storage connection strings <connstringoci >` prefixed
4262
+ with ``config-oci ``. The hook function parses this connection string, and
4263
+ extracts the authentication details and URI details from the connection
4264
+ string. Using the information, the hook function accesses the configuration
4265
+ information in OCI Object Storage, which python-oracledb will use to connect
4266
+ to Oracle Database. See :ref: `importconfigociplugin ` for more information.
4267
+
4268
+ .. versionadded :: 3.0.0
4269
+
4270
+ .. _configazureplugin :
4271
+
4272
+ Azure App Configuration Provider Plugin
4273
+ ---------------------------------------
4274
+
4275
+ ``oracledb.plugins.azure_config_provider `` is a plugin that provides access to
4276
+ the configuration information stored in :ref: `Azure App Configuration
4277
+ <azureappconfig>` provider. Importing this plugin defines and
4278
+ :meth: `registers <oracledb.register_protocol()> ` the hook function that
4279
+ handles :ref: `Azure App Configuration connection string <connstringazure >`
4280
+ prefixed with ``config-azure ``. The hook function parses this connection
4281
+ string, and extracts the authentication details and URI details from the
4282
+ connection string. Using the information, the hook function accesses the
4283
+ configuration information in Azure App Configuration, which python-oracledb
4284
+ will use to connect to Oracle Database. See :ref: `importconfigazureplugin `
4285
+ for more information.
4286
+
4287
+ .. versionadded :: 3.0.0
0 commit comments