Streams-EventStoreSample.ipynb

{
 "cells": [
  {
   "attachments": {
    "how-it-works.jpg": {
     "image/jpeg": "/9j/4AAQSkZJRgABAQAAkACQAAD/4QCARXhpZgAATU0AKgAAAAgABQESAAMAAAABAAEAAAEaAAUAAAABAAAASgEbAAUAAAABAAAAUgEoAAMAAAABAAIAAIdpAAQAAAABAAAAWgAAAAAAAACQAAAAAQAAAJAAAAABAAKgAgAEAAAAAQAAAlKgAwAEAAAAAQAAAXIAAAAA/+EJIWh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC8APD94cGFja2V0IGJlZ2luPSLvu78iIGlkPSJXNU0wTXBDZWhpSHpyZVN6TlRjemtjOWQiPz4gPHg6eG1wbWV0YSB4bWxuczp4PSJhZG9iZTpuczptZXRhLyIgeDp4bXB0az0iWE1QIENvcmUgNS40LjAiPiA8cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPiA8cmRmOkRlc2NyaXB0aW9uIHJkZjphYm91dD0iIi8+IDwvcmRmOlJERj4gPC94OnhtcG1ldGE+ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgPD94cGFja2V0IGVuZD0idyI/PgD/7QA4UGhvdG9zaG9wIDMuMAA4QklNBAQAAAAAAAA4QklNBCUAAAAAABDUHYzZjwCyBOmACZjs+EJ+/+IPYElDQ19QUk9GSUxFAAEBAAAPUGFwcGwCEAAAbW50clJHQiBYWVogB+MAAQAEAA0AOAAnYWNzcEFQUEwAAAAAQVBQTAAAAAAAAAAAAAAAAAAAAAAAAPbWAAEAAAAA0y1hcHBsAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAARZGVzYwAAAVAAAABiZHNjbQAAAbQAAAQ2Y3BydAAABewAAAAjd3RwdAAABhAAAAAUclhZWgAABiQAAAAUZ1hZWgAABjgAAAAUYlhZWgAABkwAAAAUclRSQwAABmAAAAgMYWFyZwAADmwAAAAgdmNndAAADowAAAAwbmRpbgAADrwAAAA+Y2hhZAAADvwAAAAsbW1vZAAADygAAAAoYlRSQwAABmAAAAgMZ1RSQwAABmAAAAgMYWFiZwAADmwAAAAgYWFnZwAADmwAAAAgZGVzYwAAAAAAAAAIRGlzcGxheQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAG1sdWMAAAAAAAAAIwAAAAxockhSAAAAFAAAAbRrb0tSAAAADAAAAchuYk5PAAAAEgAAAdRpZAAAAAAAEgAAAeZodUhVAAAAFAAAAfhjc0NaAAAAFgAAAgxkYURLAAAAHAAAAiJubE5MAAAAFgAAAj5maUZJAAAAEAAAAlRpdElUAAAAFAAAAmRyb1JPAAAAEgAAAnhlc0VTAAAAEgAAAnhhcgAAAAAAFAAAAop1a1VBAAAAHAAAAp5oZUlMAAAAFgAAArp6aFRXAAAADAAAAtB2aVZOAAAADgAAAtxza1NLAAAAFgAAAup6aENOAAAADAAAAtBydVJVAAAAJAAAAwBmckZSAAAAFgAAAyRtcwAAAAAAEgAAAzpoaUlOAAAAEgAAA0x0aFRIAAAADAAAA15jYUVTAAAAGAAAA2plc1hMAAAAEgAAAnhkZURFAAAAEAAAA4JlblVTAAAAEgAAA5JwdEJSAAAAGAAAA6RwbFBMAAAAEgAAA7xlbEdSAAAAIgAAA85zdlNFAAAAEAAAA/B0clRSAAAAFAAABABwdFBUAAAAFgAABBRqYUpQAAAADAAABCoATABDAEQAIAB1ACAAYgBvAGoAac7st+wAIABMAEMARABGAGEAcgBnAGUALQBMAEMARABMAEMARAAgAFcAYQByAG4AYQBTAHoA7QBuAGUAcwAgAEwAQwBEAEIAYQByAGUAdgBuAP0AIABMAEMARABMAEMARAAtAGYAYQByAHYAZQBzAGsA5gByAG0ASwBsAGUAdQByAGUAbgAtAEwAQwBEAFYA5AByAGkALQBMAEMARABMAEMARAAgAGMAbwBsAG8AcgBpAEwAQwBEACAAYwBvAGwAbwByIA8ATABDAEQAIAZFBkQGSAZGBikEGgQ+BDsETAQ+BEAEPgQyBDgEOQAgAEwAQwBEIA8ATABDAEQAIAXmBdEF4gXVBeAF2V9pgnIAIABMAEMARABMAEMARAAgAE0A4AB1AEYAYQByAGUAYgBuAP0AIABMAEMARAQmBDIENQRCBD0EPgQ5ACAEFgQaAC0ENAQ4BEEEPwQ7BDUEOQBMAEMARAAgAGMAbwB1AGwAZQB1AHIAVwBhAHIAbgBhACAATABDAEQJMAkCCRcJQAkoACAATABDAEQATABDAEQAIA4qDjUATABDAEQAIABlAG4AIABjAG8AbABvAHIARgBhAHIAYgAtAEwAQwBEAEMAbwBsAG8AcgAgAEwAQwBEAEwAQwBEACAAQwBvAGwAbwByAGkAZABvAEsAbwBsAG8AcgAgAEwAQwBEA4gDswPHA8EDyQO8A7cAIAO/A7gDzAO9A7cAIABMAEMARABGAOQAcgBnAC0ATABDAEQAUgBlAG4AawBsAGkAIABMAEMARABMAEMARAAgAGEAIABDAG8AcgBlAHMwqzDpMPwATABDAEQAAHRleHQAAAAAQ29weXJpZ2h0IEFwcGxlIEluYy4sIDIwMTkAAFhZWiAAAAAAAADzFgABAAAAARbKWFlaIAAAAAAAAHHAAAA5igAAAWdYWVogAAAAAAAAYSMAALnmAAAT9lhZWiAAAAAAAAAj8gAADJAAAL3QY3VydgAAAAAAAAQAAAAABQAKAA8AFAAZAB4AIwAoAC0AMgA2ADsAQABFAEoATwBUAFkAXgBjAGgAbQByAHcAfACBAIYAiwCQAJUAmgCfAKMAqACtALIAtwC8AMEAxgDLANAA1QDbAOAA5QDrAPAA9gD7AQEBBwENARMBGQEfASUBKwEyATgBPgFFAUwBUgFZAWABZwFuAXUBfAGDAYsBkgGaAaEBqQGxAbkBwQHJAdEB2QHhAekB8gH6AgMCDAIUAh0CJgIvAjgCQQJLAlQCXQJnAnECegKEAo4CmAKiAqwCtgLBAssC1QLgAusC9QMAAwsDFgMhAy0DOANDA08DWgNmA3IDfgOKA5YDogOuA7oDxwPTA+AD7AP5BAYEEwQgBC0EOwRIBFUEYwRxBH4E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ooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigD/9D9qKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigD/9H9qKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigD/9L9qKKKKACiiigAooooAKK8N+KX7Qnw7+FLPp+rXL6jrQXcuk6eBLcjOdplJIjgVscGRhnsK+MNU/bA+M3jS/fTvhzoVtZYcp5dpZz63drk8eYyBI4W55BUj3wK7aGX1qq5oqy7s+2yLw9zvNaX1ijT5KW/PN8qt3XVrzSa8z9QMj1oyPWvy2Gq/t06mxuYY/FESv8AMEW30mBRn0WQbh9CTT/M/bv9PFX/AHzov+Fb/wBl/wDT2H/gX/APcfhfJaSzPCp/9ff/ALU/UbI9aMj1r8ufM/bv9PFX/fOi/wCFHmft3+nir/vnRf8ACj+y/wDp7D/wL/gB/wAQwf8A0NML/wCDf/tT9Rsj1oyPWvy58z9u/wBPFX/fOi/4UeZ+3f6eKv8AvnRf8KP7L/6ew/8AAv8AgB/xDB/9DTC/+Df/ALU/UbI9aMj1r8ufM/bv9PFX/fOi/wCFHmft3+nir/vnRf8ACj+y/wDp7D/wL/gB/wAQwf8A0NML/wCDf/tT9Rsj1oyPWvy58z9u/wD6mr/vnRf8KPM/bv8ATxV/3zov+FH9l/8AT2H/AIF/wA/4hg/+hphf/Bv/ANqfqNketGR61+XPmft3+nir/vnRf8KPM/bv9PFX/fOi/wCFH9l/9PYf+Bf8AP8AiGD/AOhphf8Awb/9qfqNketGR61+XPmft3+nir/vnRf8KPM/bv8ATxV/3zov+FH9l/8A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oufF0F5azR/aIdRvHkaYL5kciGF1mkj2MpwrcEMAw6nxx4KsfHeiRaNeXt7prW17aajbXmnyJHcwXVlIJYnQyJIhww5V0ZWGQRXZUUAeHeIvgH4V8SahrU1zqWr22leKp4LnxNoltPEmna5NbxRQbrtTE0wEsUMUc6xSRpOiBJAylgev8efDjSPH7+H7m+vL/Tbzwvqbavpd1psqwywXZtZ7Pd86OjqIbiQbGUqc8gjivQqKAPBm/Z98MHQ4rRdY1pfEEWvjxT/wlImgOsNrX2c2ZumJgNqc2h+zeV5HlCH5AgAGNfSPgl4W0iXSro32rX11pPiq58Yx3N7dmaWXVLu2mtZDKdoDQ+XO+2IAKnyhAFVVHsVFAHgafs9eGrK10hdC13X9I1Hw/qeq6jpGq21zC95Zxa3KZr6xUzQyRy2Mznd5MySbWWNlIaOMr2GhfCfwpofgHVfhv/peoaNrcmryX4vpzNPOdcllmvN0uAfneZyP7oOBwBXplFAHz1d/s5+HtY06/wBN8UeJvEuupqXhi/8AB85vbuBR/Y9+qq0Sxw28UayR7crMF8wn77MAAO58TfCTwZ4ymnbxLBNfW934Zu/CVzavKVgm0y+aN5gwXDeYTEuHBBXnFemUUAeTeEfhLa+GPEdt4tv/ABHr/iTVbPSptFgn1i5ikEdjLNHNsEcEMKFw0SgykGRwPnZjgjrLPwVotnq3iXVwJZn8V/Z/7QilfMRW3tvsqqgABUNF97k5PPFdbRQB89aT+zj4Y060t7G+8Q+I9Yt7Dw9qnhXTk1C9jf7Fo+qpFHJBGY4YzI8aQRrHPMZJsL87tzn0qD4d+H7fxR4f8Xobg6h4a0K78O2RMn7s2V69o8vmLj5pC1nFhuMfNxzXd0UAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABRRRQAUUUUAFFFFABUflReb5+xfNC7RJtG/b6bsZx7ZxUlFAESwQIWKRopZt7EIoLN03Hjk479aeEQbcKBt4XgcfT0/CnUUARpFFGzvGio0h3OyqFLH1YgAk+5pEghjRo440RGJLKqKFJPUkAYJPfNS0UAM8tMk7V5G08DlfTp09ulNEEAh+zCJBDgr5YRQmD1G3G3B+lS0UAMREjG1FVQMDCgAccDoB0FPoooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKAP/W/aiiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooAKKKKACiiigAooooA//Z"
    }
   },
   "cell_type": "markdown",
   "metadata": {
    "collapsed": true
   },
   "source": [
    "# IBM Streams Event Store sample application\n",
    "\n",
    "This sample demonstrates creating a Streams Python application that ingests data into a Db2 Event Store table and viewing the metrics of the insert operation.\n",
    "\n",
    "In this notebook, you'll see examples of how to :\n",
    " 1. [Setup your data connections](#setup)\n",
    " 2. [Create the application](#create)\n",
    " 3. [Submit the application](#launch)\n",
    " 4. [Connect to the running instance to view metrics](#view)\n",
    " 5. [Stop the application](#cancel)\n",
    "\n",
    "# Overview\n",
    "\n",
    "**About the sample**\n",
    "\n",
    "This application simulates data tuples that are inserted as rows in a Db2 Event Store table.\n",
    "\n",
    "**How it works**\n",
    "\n",
    "The Python application created in this notebook is submitted to the IBM Streams service for execution. Once the application is running in the service, you can connect to the service instance from the notebook to retrieve the metrics.\n",
    "\n",
    "![how-it-works.jpg](attachment:how-it-works.jpg)\n",
    "\n",
    "\n",
    "### Documentation\n",
    "\n",
    "- [Streams Python development guide](https://ibmstreams.github.io/streamsx.documentation/docs/latest/python/)\n",
    "- [Streams Python API](https://streamsxtopology.readthedocs.io/)\n",
    "- [Db2 Event Store install and set up](https://www.ibm.com/support/knowledgecenter/en/SSGNPV_2.0.0/local/installsetup.html)\n",
    "\n",
    "\n",
    "<a name=\"setup\"></a>\n",
    "# 1. Setup\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 1.1 Add credentials for the IBM Streams service\n",
    "\n",
    "In order to submit a Streams application you need to provide the name of the Streams instance.\n",
    "\n",
    "1. From the navigation menu, click **Services > instances**.\n",
    "2. Click the **Provisioned Instances** tab.\n",
    "3. Update the value of `streams_instance_name` in the cell below according to your Streams instance name."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "from icpd_core import icpd_util\n",
    "streams_instance_name = \"sample-streams\" ## Change this to Streams instance\n",
    "\n",
    "try:\n",
    "    cfg=icpd_util.get_service_instance_details(name=streams_instance_name, instance_type=\"streams\")\n",
    "except TypeError:\n",
    "    cfg=icpd_util.get_service_instance_details(name=streams_instance_name)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 1.2 Import  the `streamsx.eventstore` package and verify the package version"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "import streamsx.eventstore as es\n",
    "import streamsx.topology.context\n",
    "print(\"INFO: streamsx package version: \" + streamsx.topology.context.__version__)\n",
    "print(\"INFO: streamsx.eventstore package version: \" + es.__version__)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### 1.3 Configure the connection to Db2 Event Store\n",
    "\n",
    "Update the name for the EventStore service/instance name.\n",
    "\n",
    "1. From the navigation menu, click **Services > Instances**.\n",
    "2. Update the value of `eventstore_instance` in the cell below according to your Event Store instance name.\n",
    "3. Click **View details** for your Event Store instance.\n",
    "4. Update the values of `es_db` (Database name), `deployment_id` and `es_connection` (Scala Connection URL) in the cell below according to your Event Store instance settings.\n",
    "5. Set the values for `host` and `port` from Cloud Pak for Data URL"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Change the name according to your Event Store instance\n",
    "eventstore_instance = 'EventStore-1'\n",
    "\n",
    "# Database name\n",
    "es_db = 'EVENTDB'\n",
    "\n",
    "# Deployment id\n",
    "deployment_id = 'db2eventstore-1591210823323'\n",
    "\n",
    "# Access information: Scala Connection URL\n",
    "es_connection = # Copy Scala Connection URL from Database Details page\n",
    "\n",
    "# Cloud Pak for Data host and port, change values below\n",
    "host = 'zen-cpd-zen.apps.cpd-001.sample.com' # host from Cloud Pak for Data URL\n",
    "port = '443' # port from Cloud Pak for Data URL\n",
    "\n",
    "# Cloud Pak for Data project/namespace\n",
    "prj = 'zen'"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### 1.3.1 SSL - Keystore/Truststore\n",
    "Functions to retrieve certificate file location and password. Information is mandatory for setting up the SSL connection between Event Store client and server."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "import requests\n",
    "from icpd_core import icpd_util\n",
    "\n",
    "def get_certificate(deployment_id):\n",
    "    \"\"\"Retrieve keystore and truststore file location for Event Store service in Cloud Pak for Data.\n",
    "    Example::\n",
    "        es_truststore, es_keystore = get_certificate(deployment_id)\n",
    "    Args:\n",
    "        deployment_id(str): The deployment ID of the Event Store instance\n",
    "    Returns:\n",
    "        truststore, keystore\n",
    "    .. warning:: The function can be used only in Cloud Pak for Data\n",
    "    \"\"\"\n",
    "    clientkeystore = '/user-home/_global_/dbdrivers/eventstore_metadata/'+deployment_id+'/clientkeystore'\n",
    "    es_truststore = clientkeystore\n",
    "    es_keystore = clientkeystore\n",
    "    return es_truststore, es_keystore\n",
    "\n",
    "def get_keystore_password(deployment_id, host, port, prj):\n",
    "    \"\"\"Retrieve keystore password and truststore password for Event Store service in Cloud Pak for Data.\n",
    "    Example::\n",
    "        es_truststore_password, es_keystore_password = get_keystore_password(deployment_id, host, port)\n",
    "    Args:\n",
    "        deployment_id(str): The deployment ID of the Event Store instance\n",
    "        host(str): Cloud Pak for Data host\n",
    "        port(str): Cloud Pak for Data port\n",
    "    Returns:\n",
    "        es_truststore_password, es_keystore_password\n",
    "    .. warning:: The function can be used only in Cloud Pak for Data\n",
    "    \"\"\"\n",
    "    eventstore_cfg=icpd_util.get_service_instance_details(name=eventstore_instance)\n",
    "    #print(eventstore_cfg)\n",
    "    token = eventstore_cfg['user_token']\n",
    "\n",
    "    session=requests.session()\n",
    "    requests.packages.urllib3.disable_warnings()\n",
    "    rest_url = 'https://' + host + ':' + port + '/icp4data-databases/'+deployment_id+'/'+prj+'/com/ibm/event/api/v1/oltp/keystore_password'\n",
    "    print(rest_url)\n",
    "    response = session.get(rest_url, headers={\"Authorization\": \"Bearer \" + token}, verify=False)\n",
    "    if response.status_code==200:\n",
    "        es_truststore_password=response.text\n",
    "        es_keystore_password=es_truststore_password\n",
    "    return es_truststore_password, es_keystore_password"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### 1.3.2 Setup application configuration\n",
    "\n",
    "Run the cell below to configure the connection for the IBM Streams application.\n",
    "\n",
    "The connection details and credentials are stored in an application configuration for IBM Streams application. As name for application configuration is the name of Event Store instance used (`eventstore_instance`). The application configuration contains the following information:\n",
    "* Name of the database (`es_db`)\n",
    "* SCALA connection string (`es_connection`)\n",
    "* Event Store user and password (`es_user` and `es_password`)\n",
    "* Passwords for SSL certifcates (`es_truststore_password` and `es_keystore_password`)\n",
    "\n",
    "The \"EventStoreWriter\" in the application is configured with the name of the application configuration for the connection details stored in the `app_cfg` variable.\n",
    "Furthermore the \"EventStoreWriter\" requires the location of the truststore and keystore for the SSL connection (`es_truststore` and `es_keystore`)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "try:\n",
    "    from streamsx.rest_primitives import Instance\n",
    "except ImportError:\n",
    "    # streamsx < 1.15.1\n",
    "    from streamsx.rest import Instance\n",
    "\n",
    "import streamsx.topology.context\n",
    "import streamsx.eventstore as es\n",
    "import getpass\n",
    "\n",
    "cfg[streamsx.topology.context.ConfigParams.SSL_VERIFY] = False\n",
    "instance = Instance.of_service(cfg)\n",
    "\n",
    "# retrieve certificate location\n",
    "es_truststore, es_keystore = get_certificate(deployment_id)\n",
    "\n",
    "# check if application configuration exists\n",
    "eventstore_app_config = instance.get_application_configurations(name=eventstore_instance)\n",
    "if eventstore_app_config:\n",
    "    app_cfg = eventstore_instance\n",
    "else:\n",
    "    es_user = input(\"Event Store user:\")\n",
    "    es_password = getpass.getpass('Event Store password for user '+es_user+':')\n",
    "    es_truststore_password, es_keystore_password = get_keystore_password(deployment_id, host, port, prj)\n",
    "    # create application configuration\n",
    "    app_cfg = es.configure_connection(instance, name=eventstore_instance, database=es_db, connection=es_connection, user=es_user, password=es_password, keystore_password=es_keystore_password, truststore_password=es_truststore_password)\n",
    "\n",
    "print(app_cfg)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id=\"create\"></a>\n",
    "# 2. Create the application\n",
    "This application is going to ingest simulated tuples.\n",
    "\n",
    "These simulated tuples are inserted as rows into a table using Db2 Event Store Scala API. This functionality is provided by `streamsx.eventstore.Insert()` as \"EventStoreWriter\".\n",
    "\n",
    "In this example we create a table of two columns:\n",
    "**| ID:Long  |  NAME:String |**\n",
    "\n",
    "In the application we define the type `tuple<int64 ID, rstring NAME>` as IBM Streams schema.\n",
    "\n",
    "Important: The tuple field types and positions in the IBM Streams schema must match the field names in your IBM Db2 Event Store table schema exactly.\n",
    "\n",
    "Supported types: [Mapping of Event Store types to SPL types](https://ibmstreams.github.io/streamsx.eventstore/doc/spldoc/html/tk$com.ibm.streamsx.eventstore/op$com.ibm.streamsx.eventstore$EventStoreSink$1.html)\n",
    "\n",
    "\n",
    "In this example, the sharding key and the primary key are defined on the same column `ID`.\n",
    "\n",
    "Databases in IBM Db2 Event Store are partitioned into shards. Any given IBM Db2 Event Store node (in a multi-node IBM Db2 Event Store cluster) contains 0, 1, or N shards of the defined database. In addition to the mandatory shard key, you can optionally provide a primary key. When you define a primary key, IBM Db2 Event Store ensures that only a single version of each primary key exists in the database.\n",
    "\n",
    "**If the table does not exist in the database, then the table is created by the \"EventStoreWriter\".**\n",
    "\n",
    "All Streams applications start with  a `Topology` object, so start by creating one:\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "from streamsx.topology.topology import Topology\n",
    "\n",
    "topo = Topology(name=\"EventStoreInsertSample\", namespace=\"sample\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a id=\"create\"></a>\n",
    "### 2.0.1 (OPTIONAL) Add downloaded streamsx.eventstore toolkit to the topology\n",
    "\n",
    "Uncomment the lines in the cell below, if you need to use the latest toolkit downloaded form GitHub."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "#import streamsx.spl.toolkit as toolkit\n",
    "#import streamsx.eventstore as es\n",
    "#eventstore_toolkit = es.download_toolkit()\n",
    "#if eventstore_toolkit is not None: \n",
    "#    toolkit.add_toolkit(topo, eventstore_toolkit) # add event store toolkit to topology"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 2.1 Define the application\n",
    "\n",
    "\n",
    "First step is to define a data source that produces the data being processed.\n",
    "For this, create a `Stream` called  `pulse` that will contain the simulated data with two attributes.\n",
    "A `Stream` is a potentially infinite sequence of tuples containing the data to be analyzed.\n",
    "\n",
    "Next, use the data source `Stream` as input for the \"EventStoreWriter\".\n",
    "\n",
    "**Define the table schema**\n",
    "\n",
    "* The table name is defined in the `table` variable. This is applied as `table` parameter to the `streamsx.eventstore.Insert()` class\n",
    "* The table schema is specified by the Stream type `tuple<int64 ID, rstring NAME>`\n",
    "* Primary key of the table is applied as `primary_key` parameter to the `streamsx.eventstore.Insert()` class"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "import streamsx.spl.op as op\n",
    "import streamsx.eventstore as es\n",
    "from streamsx.topology.schema import StreamSchema\n",
    "import random\n",
    "import time\n",
    "\n",
    "\n",
    "# This application creates a table with the name below\n",
    "table = 'StreamsEventStoreSampleTable'\n",
    "\n",
    "def generate_data():\n",
    "    counter = 0\n",
    "    while True:\n",
    "        #yield a random id and name\n",
    "        yield  {\"NAME\": \"id_\" + str(random.randint(0,10)), \"ID\": counter}\n",
    "        counter = counter + 1\n",
    "        time.sleep(0.01)\n",
    "\n",
    "# convert it to SPL schema for the Event Store operator\n",
    "tuple_schema = StreamSchema(\"tuple<int64 ID, rstring NAME>\")\n",
    "# Generates data for a stream of two attributes. Each attribute maps to a column using the same name of the DB2 Event Store table.\n",
    "pulse = topo.source(generate_data, name=\"GeneratedData\").map(lambda tpl: (tpl[\"ID\"], tpl[\"NAME\"]), schema=tuple_schema)\n",
    "\n",
    "\n",
    "# configure the number of tuples that are inserted as batch\n",
    "batch_size=100\n",
    "\n",
    "# insert tuple data into table as rows\n",
    "pulse.for_each(es.Insert(config=app_cfg, table=table, batch_size=batch_size, primary_key='ID', partitioning_key='ID', truststore=es_truststore, keystore=es_keystore), name='ES_Inserter')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a name=\"launch\"></a>\n",
    "\n",
    "# 3. Submit the application\n",
    "A running Streams application is called a *job*. This next cell submits the application for execution and prints the resulting job id."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "from streamsx.topology import context\n",
    "\n",
    "# Disable SSL certificate verification if necessary\n",
    "cfg[context.ConfigParams.SSL_VERIFY] = False\n",
    "# submit the topology 'topo'\n",
    "submission_result = context.submit (\"DISTRIBUTED\", topo, config = cfg)\n",
    "\n",
    "# The submission_result object contains information about the running application, or job\n",
    "if submission_result.job:\n",
    "    streams_job = submission_result.job\n",
    "    print (\"JobId: \", streams_job.id , \"\\nJob name: \", streams_job.name)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a name=\"view\"></a>\n",
    "\n",
    "# 4. Collect metrics from the job\n",
    "Now that the job is started, connect to the instance and view the metrics of the \"Event Store Writer\".\n",
    "\n",
    "The following metrics are collected: \n",
    "* nWriteSuccesses - number of successful inserts\n",
    "* nWriteFailures - number of failed inserts\n",
    "* insertTimeMin - minimum time of insert operation in ms\n",
    "* insertTimeAvg - average time of insert operation in ms\n",
    "* insertTimeMax - maximum time of insert operation in ms\n",
    "* nActiveInserts - indicates if inserts is active or not (1: active, 0: inactive)\n",
    "\n",
    "It prints one line per metrics fetch every 5 seconds for 2 minutes.\n",
    "\n",
    "**Collecting operator metrics**\n",
    "\n",
    "Each kind of operator provides different metrics with specific names. Find below example code to retrieve all operator metrics from all jobs in a Streams instance:\n",
    "\n",
    "---------\n",
    "```\n",
    "try:\n",
    "    from streamsx.rest_primitives import Instance\n",
    "except ImportError:\n",
    "    # streamsx < 1.15.1\n",
    "    from streamsx.rest import Instance\n",
    "\n",
    "from streamsx.topology import context\n",
    "\n",
    "# Disable SSL certificate verification if necessary\n",
    "cfg[context.ConfigParams.SSL_VERIFY] = False\n",
    "# Streams instance object\n",
    "instance = Instance.of_service(cfg)\n",
    "# Get list of all running jobs in the Streams instance\n",
    "job_list = instance.get_jobs()\n",
    "for j in job_list:\n",
    "    job_id = j.id\n",
    "    job_name = j.name\n",
    "    print(\"JobId: \"+job_id + \" Name: \"+ job_name)\n",
    "    # Loop over each operator of the job\n",
    "    op_list = j.get_operators()\n",
    "    for op in op_list:\n",
    "        print(\"Operator name:\" + op.name + \" kind: \" + op.operatorKind)\n",
    "        # List all metrics of the operator\n",
    "        m = op.get_metrics()\n",
    "        if len(m) > 0:\n",
    "            print(\"Metric \"+m[0].name + \": \"+str(m[0].value))\n",
    "```\n",
    "---------"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "try:\n",
    "    from streamsx.rest_primitives import Instance\n",
    "except ImportError:\n",
    "    # streamsx < 1.15.1\n",
    "    from streamsx.rest import Instance\n",
    "\n",
    "import streamsx.topology.context\n",
    "from time import sleep\n",
    "from datetime import datetime\n",
    "\n",
    "# retrieve metrics from submitted job\n",
    "j = submission_result.job\n",
    "\n",
    "interval = 5 # collect metrics after n seconds\n",
    "n = 24 # collect n times, -1 infinite\n",
    "i = 0\n",
    "metrics_info = \"\"\n",
    "sleep(20) # initial delay since job startup takes some time\n",
    "while True:\n",
    "    i = i + 1\n",
    "    op = j.get_operators('ES_Inserter')[0]\n",
    "    if op.operatorKind == 'com.ibm.streamsx.eventstore::EventStoreSink':\n",
    "        time_info = datetime.now().strftime('%Y-%m-%d %H:%M:%S')\n",
    "        for metric in (\"nWriteSuccesses\",\"nWriteFailures\",\"insertTimeMin\",\"insertTimeAvg\",\"insertTimeMax\",\"nActiveInserts\"):\n",
    "            m = op.get_metrics(name=metric)\n",
    "            if len(m) > 0:\n",
    "                metrics_info = metrics_info + \" \" + m[0].name + \": \" + str(m[0].value)\n",
    "\n",
    "        print(time_info + \" \" + metrics_info)\n",
    "    if i == n:\n",
    "        break\n",
    "    sleep(interval)\n",
    "    metrics_info = \"\""
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "\n",
    "## 4.1 See job status \n",
    "\n",
    "\n",
    "The tools available to monitor the running application depend on the version of Streams and your development environment.\n",
    "\n",
    "- **If you are using a Cloud Pak for Data 3.5 project:**  When you submit the `Topology`, you create a new <i>job run</i>. The job represents the application and the job run represents a single instance of the running application. \n",
    "\n",
    "    1. Open your project and click on the **Jobs** tab. This will show a list of the project's jobs.\n",
    "    1. Under the **Job name** column, find your job based on the `Job Name` [printed when you submitted the job](#launch). This will list all of the job runs for that job.\n",
    "    1. Click the **Run name** to open the job run. The run name will be the same as the `Job Name` printed above.\n",
    "    1. This will open the Job Details page.\n",
    "    \n",
    "        1. To open the Job Graph, click the **Streams job graph** link.\n",
    "        \n",
    "        1. To download logs, click the **Logs** tab and click **Create snapshot**, then download the snapshot.    \n",
    "    \n",
    "\n",
    "- **For all other development environments and versions of Streams**, [see this page for more information](http://ibmstreams.github.io/streamsx.documentation/docs/spl/quick-start/qs-4).\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a name=\"cancel\"></a>\n",
    "\n",
    "# 5. Cancel the job"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The Streams job is running in the Streams service. You can cancel it within the notebook or delete it from **Projects** > **Jobs**."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "# cancel the job directly using the Job object\n",
    "streams_job.cancel()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Summary\n",
    "\n",
    "We started with a `Stream` called `pulse`, which contained the data we wanted to insert. Next, we used the `pulse` stream as input for the \"Event Store Writer\" to insert rows in the specified table.  \n",
    "\n",
    "After submitting the application to the Streams service, we connected to the instance via REST and displayed the \"Event Store Writer\" metrics to see the progress within the notebook.\n",
    "\n",
    "\n",
    "Learn more about the [Python API from the documentation](https://streamsxtopology.readthedocs.io/en/stable/index.html/). You can also visit the [Streams community for more resources](https://ibm.biz/streams-articles)."
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3.6",
   "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.6.10"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 1
}