Package: google-datacatalog-oracle-connector
google-datacatalog-oracle-connectorLibrary for ingesting Oracle metadata into Google Cloud Data Catalog.Disclaimer: This is not an officially supported Google product.Table of Contents1. Installation1.1. Mac/Linux1.2. Windows1.3. Install from source1.3.1. Get the code1.3.2. Create and activate avirtualenv1.3.3. Install the library2. Environment setup2.1. Auth credentials2.1.1. Create a service account and grant it below roles2.1.2. Download a JSON key and save it as2.2 Set up Oracle Driver (Optional)2.2.1 Set Oracle client for Linux (Cloud Shell)2.2.2 Set Oracle client for Mac2.3. Set environment variables3. Run entry point3.1. Run Python entry point3.2. Run Docker entry point4 Scripts inside tools4.1. Run clean up5. Developer environment5.1. Install and run Yapf formatter5.2. Install and run Flake8 linter5.3. Run Tests6. Metrics7. Troubleshooting1. InstallationInstall this library in avirtualenvusing pip.virtualenvis a tool to
create isolated Python environments. The basic problem it addresses is one of
dependencies and versions, and indirectly permissions.Withvirtualenv, it's possible to install this library without needing system
install permissions, and without clashing with the installed system
dependencies. Make sure you use Python 3.6+.1.1. Mac/Linuxpip3installvirtualenv
virtualenv--pythonpython3.6<your-env>source<your-env>/bin/activate
<your-env>/bin/pipinstallgoogle-datacatalog-oracle-connector1.2. Windowspip3installvirtualenv
virtualenv--pythonpython3.6<your-env>
<your-env>\Scripts\activate
<your-env>\Scripts\pip.exeinstallgoogle-datacatalog-oracle-connector1.3. Install from source1.3.1. Get the codegitclonehttps://github.com/GoogleCloudPlatform/datacatalog-connectors-rdbms/cddatacatalog-connectors-rdbms/google-datacatalog-oracle-connector1.3.2. Create and activate avirtualenvpip3installvirtualenv
virtualenv--pythonpython3.6<your-env>source<your-env>/bin/activate1.3.3. Install the librarypipinstall.2. Environment setup2.1. Auth credentials2.1.1. Create a service account and grant it below rolesData Catalog Admin2.1.2. Download a JSON key and save it as<YOUR-CREDENTIALS_FILES_FOLDER>/oracle2dc-datacatalog-credentials.jsonPlease notice this folder and file will be required in next steps.2.2 Set up Oracle Driver  (Optional)This is step is needed when you are running the connector on a machine that does not have the Oracle installation.2.2.1 Set Oracle client for Linux (Cloud Shell)Download the zip file:https://oracle.github.io/odpi/doc/installation.html#linux# Unzip itunzipinstantclient-basic-linux.x64-19.5.0.0.0dbru.zip# Set Oracle library ENV Var on the unzip direxportLD_LIBRARY_PATH=/oracle2datacatalog/bin/instantclient_19_52.2.2  Set Oracle client for MacDownload the zip file:https://oracle.github.io/odpi/doc/installation.html#macos# Unzip itunzipinstantclient-basic-macos.x64-19.3.0.0.0dbru.zip# Set Oracle library ENV Var on the unzip direxportLD_LIBRARY_PATH=/oracle2datacatalog/bin/instantclient_19_32.3. Set environment variablesReplace below values according to your environment:exportGOOGLE_APPLICATION_CREDENTIALS=data_catalog_credentials_fileexportORACLE2DC_DATACATALOG_PROJECT_ID=google_cloud_project_idexportORACLE2DC_DATACATALOG_LOCATION_ID=google_cloud_location_idexportORACLE2DC_ORACLE_SERVER=oracle_serverexportORACLE2DC_ORACLE_SERVER_PORT=oracle_server_portexportORACLE2DC_ORACLE_USERNAME=oracle_usernameexportORACLE2DC_ORACLE_PASSWORD=oracle_passwordexportORACLE2DC_ORACLE_DATABASE_SERVICE=oracle_db_serviceexportORACLE2DC_RAW_METADATA_CSV=oracle_raw_csv(IfsuppliedignorestheOracleservercredentials)3. Run entry point3.1. Run Python entry pointVirtualenvgoogle-datacatalog-oracle-connector\--datacatalog-project-id=$ORACLE2DC_DATACATALOG_PROJECT_ID\--datacatalog-location-id=$ORACLE2DC_DATACATALOG_LOCATION_ID\--oracle-host=$ORACLE2DC_ORACLE_SERVER\--oracle-port=$ORACLE2DC_ORACLE_SERVER_PORT\--oracle-user=$ORACLE2DC_ORACLE_USERNAME\--oracle-pass=$ORACLE2DC_ORACLE_PASSWORD\--oracle-db-service=$ORACLE2DC_ORACLE_DATABASE_SERVICE\--raw-metadata-csv=$ORACLE2DC_RAW_METADATA_CSV3.2. Run Docker entry pointdockerbuild-toracle2datacatalog.
dockerrun--rm--tty-vYOUR-CREDENTIALS_FILES_FOLDER:/dataoracle2datacatalog\--datacatalog-project-id=$ORACLE2DC_DATACATALOG_PROJECT_ID\--datacatalog-location-id=$ORACLE2DC_DATACATALOG_LOCATION_ID\--oracle-host=$ORACLE2DC_ORACLE_SERVER\--oracle-port=$ORACLE2DC_ORACLE_SERVER_PORT\--oracle-user=$ORACLE2DC_ORACLE_USERNAME\--oracle-pass=$ORACLE2DC_ORACLE_PASSWORD\--oracle-db-service=$ORACLE2DC_ORACLE_DATABASE_SERVICE\--raw-metadata-csv=$ORACLE2DC_RAW_METADATA_CSV4 Scripts inside tools4.1. Run clean up# List of projects split by comma. Can be a single value without commaexportORACLE2DC_DATACATALOG_PROJECT_IDS=my-project-1,my-project-2# Run the clean uppythontools/cleanup_datacatalog.py--datacatalog-project-ids=$ORACLE2DC_DATACATALOG_PROJECT_IDS5. Developer environment5.1. Install and run Yapf formatterpipinstall--upgradeyapf# Auto update filesyapf--in-place--recursivesrctests# Show diffyapf--diff--recursivesrctests# Set up pre-commit hook# From the root of your git project.curl-opre-commit.shhttps://raw.githubusercontent.com/google/yapf/master/plugins/pre-commit.sh
chmoda+xpre-commit.sh
mvpre-commit.sh.git/hooks/pre-commit5.2. Install and run Flake8 linterpipinstall--upgradeflake8
flake8srctests5.3. Run Testspythonsetup.pytest6. MetricsMetrics README.md7. TroubleshootingIn the case a connector execution hits Data Catalog quota limit, an error will be raised and logged with the following detailement, depending on the performed operation READ/WRITE/SEARCH:status = StatusCode.RESOURCE_EXHAUSTED
details = "Quota exceeded for quota metric 'Read requests' and limit 'Read requests per minute' of service 'datacatalog.googleapis.com' for consumer 'project_number:1111111111111'."
debug_error_string = 
"{"created":"@1587396969.506556000", "description":"Error received from peer ipv4:172.217.29.42:443","file":"src/core/lib/surface/call.cc","file_line":1056,"grpc_message":"Quota exceeded for quota metric 'Read requests' and limit 'Read requests per minute' of service 'datacatalog.googleapis.com' for consumer 'project_number:1111111111111'.","grpc_status":8}"For more info about Data Catalog quota, go to:Data Catalog quota docs.