add comment

Author: sprivite

phenex/ibis_connect.py

@@ -119,6 +119,16 @@ def _connect(self, database) -> BaseBackend:
         '''
         database, schema = database.split('.')
 
+        #
+        # In Ibis speak: catalog = collection of databases
+        #                database = collection of tables
+        #                schema = columns and column types
+        # In snowflake speak: database = collection of schemas = ibis catalog
+        #                schema = collection of tables = ibis database
+        #
+        # In the below connect method, the arguments are the SNOWFLAKE terms.
+        #
+        
         if self.SNOWFLAKE_PASSWORD:
             return ibis.snowflake.connect(
                 user=self.SNOWFLAKE_USER,