DB0201EN-Week3-1-1-Connecting.ipynb

{"cells":[{"cell_type":"markdown","metadata":{},"source":["<center>\n","    <img src=\"https://s3-api.us-geo.objectstorage.softlayer.net/cf-courses-data/CognitiveClass/Logos/organization_logo/organization_logo.png\" width=\"300\" alt=\"cognitiveclass.ai logo\"  />\n","</center>\n","\n","# Connect to Db2 database on Cloud using Python\n","\n","Estimated time needed: **15** minutes\n","\n","## Objectives\n","\n","After completing this lab you will be able to:\n","\n","*   Import the ibm_db Python library\n","*   Enter the database connection credentials\n","*   Create the database connection\n","*   Close the database connection\n"]},{"cell_type":"markdown","metadata":{},"source":["**Note:** Please follow the instructions given in the first Lab of this course to Create a database service instance of Db2 on Cloud and retrieve your database Service Credentials.\n","\n","## Import the `ibm_db` Python library\n","\n","The `ibm_db` [API ](https://pypi.python.org/pypi/ibm_db/?utm_medium=Exinfluencer&utm_source=Exinfluencer&utm_content=000026UJ&utm_term=10006555&utm_id=NA-SkillsNetwork-Channel-SkillsNetworkCoursesIBMDeveloperSkillsNetworkDB0201ENSkillsNetwork20127838-2022-01-01) provides a variety of useful Python functions for accessing and manipulating data in an IBM® data server database, including functions for connecting to a database, preparing and issuing SQL statements, fetching rows from result sets, calling stored procedures, committing and rolling back transactions, handling errors, and retrieving metadata.\n","\n","We first import the ibm_db library into our Python Application\n","\n","Execute the following cells by clicking within it and then\n","press `Shift` and `Enter` keys simultaneously\n","\n","The following required modules are pre-installed in the Skills Network Labs environment. However if you run this notebook commands in a different Jupyter environment (e.g. Watson Studio or Ananconda) you may need to install these libraries by removing the `#` sign before `!pip` in the code cell below.\n"]},{"cell_type":"code","execution_count":null,"metadata":{},"outputs":[],"source":["# These libraries are pre-installed in SN Labs. If running in another environment please uncomment lines below to install them:\n","# !pip install --force-reinstall ibm_db==3.1.0 ibm_db_sa==0.3.3\n","# Ensure we don't load_ext with sqlalchemy>=1.4 (incompadible)\n","# !pip uninstall sqlalchemy==1.4 -y && pip install sqlalchemy==1.3.24\n","# !pip install ipython-sql"]},{"cell_type":"code","execution_count":null,"metadata":{},"outputs":[],"source":["import ibm_db"]},{"cell_type":"markdown","metadata":{},"source":["When the command above completes, the `ibm_db` library is loaded in your notebook.\n","\n","## Identify the database connection credentials\n","\n","Connecting to dashDB or DB2 database requires the following information:\n","\n","*   Driver Name\n","*   Database name\n","*   Host DNS name or IP address\n","*   Host port\n","*   Connection protocol\n","*   User ID (or username)\n","*   User Password\n","\n","**Notice:** To obtain credentials please refer to the instructions given in the first Lab of this course\n","\n","Now enter your database credentials below and execute the cell with `Shift` + `Enter`\n"]},{"cell_type":"code","execution_count":null,"metadata":{},"outputs":[],"source":["#Replace the placeholder values with your actual Db2 hostname, username, and password:\n","dsn_hostname = \"YourDb2Hostname\" # e.g.: \"54a2f15b-5c0f-46df-8954-7e38e612c2bd.c1ogj3sd0tgtu0lqde00.databases.appdomain.cloud\"\n","dsn_uid = \"YourDb2Username\"        # e.g. \"abc12345\"\n","dsn_pwd = \"YoueDb2Password\"      # e.g. \"7dBZ3wWt9XN6$o0J\"\n","\n","dsn_driver = \"{IBM DB2 ODBC DRIVER}\"\n","dsn_database = \"BLUDB\"            # e.g. \"BLUDB\"\n","dsn_port = \"YourPort\"                # e.g. \"32733\" \n","dsn_protocol = \"TCPIP\"            # i.e. \"TCPIP\"\n","dsn_security = \"SSL\"              #i.e. \"SSL\""]},{"cell_type":"markdown","metadata":{},"source":["## Create the DB2 database connection\n","\n","Ibm_db API uses the IBM Data Server Driver for ODBC and CLI APIs to connect to IBM DB2 and Informix.\n","\n","Lets build the dsn connection string using the credentials you entered above\n"]},{"cell_type":"code","execution_count":null,"metadata":{},"outputs":[],"source":["#DO NOT MODIFY THIS CELL. Just RUN it with Shift + Enter\n","#Create the dsn connection string\n","dsn = (\n","    \"DRIVER={0};\"\n","    \"DATABASE={1};\"\n","    \"HOSTNAME={2};\"\n","    \"PORT={3};\"\n","    \"PROTOCOL={4};\"\n","    \"UID={5};\"\n","    \"PWD={6};\"\n","    \"SECURITY={7};\").format(dsn_driver, dsn_database, dsn_hostname, dsn_port, dsn_protocol, dsn_uid, dsn_pwd,dsn_security)\n","\n","#print the connection string to check correct values are specified\n","print(dsn)"]},{"cell_type":"markdown","metadata":{},"source":["Now establish the connection to the database\n"]},{"cell_type":"code","execution_count":null,"metadata":{},"outputs":[],"source":["#DO NOT MODIFY THIS CELL. Just RUN it with Shift + Enter\n","#Create database connection\n","\n","try:\n","    conn = ibm_db.connect(dsn, \"\", \"\")\n","    print (\"Connected to database: \", dsn_database, \"as user: \", dsn_uid, \"on host: \", dsn_hostname)\n","\n","except:\n","    print (\"Unable to connect: \", ibm_db.conn_errormsg() )\n"]},{"cell_type":"markdown","metadata":{},"source":["Congratulations if you were able to connect successfuly. Otherwise check the error and try again.\n"]},{"cell_type":"code","execution_count":null,"metadata":{},"outputs":[],"source":["#Retrieve Metadata for the Database Server\n","server = ibm_db.server_info(conn)\n","\n","print (\"DBMS_NAME: \", server.DBMS_NAME)\n","print (\"DBMS_VER:  \", server.DBMS_VER)\n","print (\"DB_NAME:   \", server.DB_NAME)"]},{"cell_type":"code","execution_count":null,"metadata":{},"outputs":[],"source":["#Retrieve Metadata for the Database Client / Driver\n","client = ibm_db.client_info(conn)\n","\n","print (\"DRIVER_NAME:          \", client.DRIVER_NAME) \n","print (\"DRIVER_VER:           \", client.DRIVER_VER)\n","print (\"DATA_SOURCE_NAME:     \", client.DATA_SOURCE_NAME)\n","print (\"DRIVER_ODBC_VER:      \", client.DRIVER_ODBC_VER)\n","print (\"ODBC_VER:             \", client.ODBC_VER)\n","print (\"ODBC_SQL_CONFORMANCE: \", client.ODBC_SQL_CONFORMANCE)\n","print (\"APPL_CODEPAGE:        \", client.APPL_CODEPAGE)\n","print (\"CONN_CODEPAGE:        \", client.CONN_CODEPAGE)"]},{"cell_type":"markdown","metadata":{},"source":["## Close the Connection\n","\n","We free all resources by closing the connection. Remember that it is always important to close connections so that we can avoid unused connections taking up resources.\n"]},{"cell_type":"code","execution_count":null,"metadata":{},"outputs":[],"source":["ibm_db.close(conn)"]},{"cell_type":"markdown","metadata":{},"source":["## Summary\n","\n","In this tutorial you established a connection to a DB2 database on Cloud database from a Python notebook using ibm_db API.\n"]},{"cell_type":"markdown","metadata":{},"source":["## Author\n","\n","<a href=\"https://www.linkedin.com/in/ravahuja?utm_medium=Exinfluencer&utm_source=Exinfluencer&utm_content=000026UJ&utm_term=10006555&utm_id=NA-SkillsNetwork-Channel-SkillsNetworkCoursesIBMDeveloperSkillsNetworkDB0201ENSkillsNetwork20127838-2022-01-01\">Rav Ahuja</a>\n","\n","## Change Log\n","\n","| Date (YYYY-MM-DD) | Version | Changed By | Change Description                 |\n","| ----------------- | ------- | ---------- | ---------------------------------- |\n","| 2021-11-17        | 2.2     | Lakshmi    | Updated library                    |\n","| 2021-07-09        | 2.1     | Malika     | Updated the connection string      |\n","| 2020-08-28        | 2.0     | Lavanya    | Moved lab to course repo in GitLab |\n","\n","<hr>\n","\n","## <h3 align=\"center\"> © IBM Corporation 2020. All rights reserved. <h3/>\n"]}],"metadata":{"kernelspec":{"display_name":"Python 3 (ipykernel)","language":"python","name":"python3"},"language_info":{"codemirror_mode":{"name":"ipython","version":3},"file_extension":".py","mimetype":"text/x-python","name":"python","nbconvert_exporter":"python","pygments_lexer":"ipython3","version":"3.9.7"},"widgets":{"state":{},"version":"1.1.2"}},"nbformat":4,"nbformat_minor":4}