docs(readme): update connection params table, pandas usage

Author: Brooke-white

README.rst

@@ -188,6 +188,9 @@ Alternatively, IAM credentials can be supplied directly to ``connect(...)`` usin
 
 Integration with pandas
 ~~~~~~~~~~~~~~~~~~~~~~~
+
+Retrieving query results as a ``pandas.DataFrame``
+
 .. code-block:: python
 
     import pandas
@@ -206,6 +209,28 @@ Integration with pandas
     >> 1        A Brief History of Time         Stephen Hawking
 
 
+Insert data stored in a ``pandas.DataFrame`` into an Amazon Redshift table
+
+.. code-block:: python
+
+    import numpy as np
+    import pandas as pd
+
+    df = pd.DataFrame(
+        np.array(
+            [
+                ["One Hundred Years of Solitude", "Gabriel García Márquez"],
+                ["A Brief History of Time", "Stephen Hawking"],
+            ]
+        ),
+        columns=["bookname", "author‎"],
+    )
+    with db_table.cursor() as cursor:
+        cursor.write_dataframe(df, "book")
+        cursor.execute("select * from book; ")
+        result = cursor.fetchall()
+
+
 Integration with numpy
 ~~~~~~~~~~~~~~~~~~~~~~
 
@@ -275,10 +300,14 @@ Connection Parameters
 +-----------------------------------+------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------+----------+
 | max_prepared_statements           | int  | The maximum number of prepared statements that can be open at once                                                                                                                                                                                                                                                                                                    | 1000                 | No       |
 +-----------------------------------+------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------+----------+
+| partner_sp_id                     | str  | The Partner SP Id used for authentication with Ping                                                                                                                                                                                                                                                                                                                   | None                 | No       |
++-----------------------------------+------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------+----------+
 | port                              | Int  | The port number of the Amazon Redshift cluster                                                                                                                                                                                                                                                                                                                        | 5439                 | No       |
 +-----------------------------------+------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------+----------+
 | preferred_role                    | str  | The IAM role preferred for the current connection                                                                                                                                                                                                                                                                                                                     | None                 | No       |
 +-----------------------------------+------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------+----------+
+| principal_arn                     | str  | The ARN of the IAM entity (user or role) for which you are generating a policy                                                                                                                                                                                                                                                                                        | None                 | No       |
++-----------------------------------+------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------+----------+
 | profile                           | str  | The name of a profile in a AWS credentials file that contains AWS credentials.                                                                                                                                                                                                                                                                                        | None                 | No       |
 +-----------------------------------+------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------+----------+
 | region                            | str  | The AWS region where the cluster is located                                                                                                                                                                                                                                                                                                                           | None                 | No       |