Update Tableau instructions

Author: sgrebnov

website/docs/clients/tableau/index.md

@@ -7,58 +7,111 @@ pagination_prev: 'clients/index'
 pagination_next: null
 ---
 
-Use [Tableau](https://www.tableau.com/) to access, visualise and analyse datasets loaded in Spice.
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
-> The world's leading analytics platform. Tableau is the broadest and deepest end-to-end data and analytics platform. Ensure the responsible use of data and drive better business outcomes with fully integrated data management and governance, visual analytics and data storytelling, and collaboration – all with Salesforce’s industry-leading Einstein built right in.
+Use instructions below to install the **Spice.ai Tableau Connector** that enables [Tableau](https://www.tableau.com/) users to easily connect to and visualize data loaded in Spice.
+
+> Tableau is the world's leading analytics platform. Tableau is the broadest and deepest end-to-end data and analytics platform. Ensure the responsible use of data and drive better business outcomes with fully integrated data management and governance, visual analytics and data storytelling, and collaboration – all with Salesforce’s industry-leading Einstein built right in.
 >
 > – [The Tableau platform](https://www.tableau.com/)
 
-## Install Tableau Desktop
+## Step 1. Install the Arrow Flight SQL JDBC Driver
 
-Download and install [Tableau Desktop](https://www.tableau.com/products/desktop/download).
+[JDBC](https://docs.oracle.com/javase/tutorial/jdbc/basics/index.html) (Java Database Connectivity) is a standard interface for connecting to and interacting with databases. The Flight SQL driver is a JDBC driver implementation based on the [Arrow Flight SQL](https://arrow.apache.org/docs/format/FlightSql.html) protocol. As Spice supports the Flight SQL protocol, the driver helps establish a connection between Tableau and Spice, enabling Tableau to execute queries and retrieve data from Spice efficiently.
 
-## Download and install the Flight SQL JDBC driver
+Download the [flight-sql-jdbc-driver.jar](https://repo1.maven.org/maven2/org/apache/arrow/flight-sql-jdbc-driver/) file to the Tableau drivers folder:
 
-[JDBC](https://docs.oracle.com/javase/tutorial/jdbc/basics/index.html) (Java Database Connectivity) is a standard way to connect to, and interact with a database. The Flight SQL driver is a JDBC driver implementation that utilizes the underlying [Flight SQL](https://arrow.apache.org/docs/format/FlightSql.html) protocol, allowing any program that connects via JDBC to seamlessly connect and interact with databases that support Flight SQL. Because Spice supports Flight SQL, this driver acts as a bridge, enabling Tableau to establish a connection with Spice, execute queries, and retrieve data.
+<Tabs>
+  <TabItem value="windows" label="Windows" default>
+    **PowerShell Install Script**
 
-1. **Download the Flight SQL JDBC driver**
+    ```powershell
+    Invoke-WebRequest -Uri "https://repo1.maven.org/maven2/org/apache/arrow/flight-sql-jdbc-driver/16.1.0/flight-sql-jdbc-driver-16.1.0.jar" -OutFile "C:\Program Files\Tableau\Drivers\flight-sql-jdbc-driver-16.1.0.jar"
+    ```
+  </TabItem>
+  <TabItem value="macos" label="macOS">
+    **Install Script**
 
-- Visit the [Flight SQL JDBC driver](https://central.sonatype.com/artifact/org.apache.arrow/flight-sql-jdbc-driver/) page
-- Select the **Versions** tab
-- Click **Browse** next to the version you want to download
-- Click the `flight-sql-jdbc-driver-XX.XX.XX.jar` file (with only the `.jar` file extension) from the list of files to download the driver jar file
+    ```bash
+    curl -L https://repo1.maven.org/maven2/org/apache/arrow/flight-sql-jdbc-driver/16.1.0/flight-sql-jdbc-driver-16.1.0.jar -o ~/Library/Tableau/Drivers/flight-sql-jdbc-driver-16.1.0.jar
+    ```
+  </TabItem>
+  <TabItem value="linux" label="Linux">
+    **Install Script**
 
-2. **Copy the downloaded jar file into the following directory based on your operating system**
+    ```bash
+    curl -L https://repo1.maven.org/maven2/org/apache/arrow/flight-sql-jdbc-driver/16.1.0/flight-sql-jdbc-driver-16.1.0.jar -o /opt/tableau/tableau_driver/jdbc/flight-sql-jdbc-driver-16.1.0.jar
+    ```
+  </TabItem>
+</Tabs>
 
-- Windows: `C:\Program Files\Tableau\Drivers`
-- Mac: `~/Library/Tableau/Drivers`
-- Linux: `/opt/tableau/tableau_driver/jdbc` - Start or restart Tableau
+## Step 2. Install Spice.ai Tableau Connector
 
-## Configure a Spice connection
+### Tableau Server
 
-1. Open **Tableau**
-2. In the **Connect** column, under **To a Server**, select **Other Databases (JDBC)**.
-3. Provide the following configuration:
+1. Download the latest `spiceai.taco` file from [Releases](https://github.com/spicehq/tableau-connector/releases)
+2. Copy to the Tableau connectors directory
 
-- **URL**: `jdbc:arrow-flight-sql://127.0.0.1:50051?useEncryption=false`
-- **Dialect**: `PostgreSQL`
-  <img width="400" src="/img/tableau/tableau-jdbc-conn.png" />
+  <Tabs>
+    <TabItem value="windows" label="Windows" default>
+      **PowerShell Install Script**
 
-4. Ensure Spice is running
-5. Click **Sign In**
+      ```powershell
+      Invoke-WebRequest -Uri "https://github.com/spicehq/tableau-connector/releases/latest/download/spiceai.taco" -OutFile "C:\Program Files\Tableau\Connectors\spiceai.taco"
+      ```
+    </TabItem>
+    <TabItem value="linux" label="Linux">
+      **Install Script**
 
-## Working with Spice datasets
+      ```bash
+      curl -L https://github.com/spicehq/tableau-connector/releases/latest/download/spiceai.taco -o /opt/tableau/connectors/spiceai.taco
+      ```
+    </TabItem>
+  </Tabs>
+
+3. Restart server: `tsm restart`
+
+### Tableau Desktop
+
+1. Download the latest `spiceai.taco` file from the [Releases](https://github.com/spiceai/tableau-connector/releases)
+2. Copy to the Tableau connectors directory
 
-Once connected, Spice datasets will be listed under the `datafusion.public` schema.
+  <Tabs>
+    <TabItem value="windows" label="Windows" default>
+      **PowerShell Install Script**
 
-:::note
+      ```powershell
+      Invoke-WebRequest -Uri "https://github.com/spicehq/tableau-connector/releases/latest/download/spiceai.taco" -OutFile "C:\Users\[USERNAME]\Documents\My Tableau Repository\Connectors\spiceai.taco"
+      ```
+    </TabItem>
+    <TabItem value="macos" label="macOS">
+      **Install Script**
 
-Tableau support is currently in alpha, and not all functionality is supported. Use **New Custom SQL** to start working with Spice datasets as shown below.
+      ```bash
+      curl -L https://github.com/spicehq/tableau-connector/releases/latest/download/spiceai.taco -o ~/Documents/My\ Tableau\ Repository/Connectors/spiceai.taco
+      ```
+    </TabItem>
+    <TabItem value="linux" label="Linux">
+      **Install Script**
 
-:::
+      ```bash
+      curl -L https://github.com/spicehq/tableau-connector/releases/latest/download/spiceai.taco -o /opt/tableau/connectors/spiceai.taco
+      ```
+    </TabItem>
+  </Tabs>
 
-<img width="800" src="/img/tableau/tableau-tables-list.png" />
+## Configure a Spice connection
+
+1. Open **Tableau**
+2. In the **Connect** column, under **To a Server**, select **Spice by Spice.ai Inc**.
+3. Configure a Spice connection to **Spice.ai OSS Self-Hosted** instance or to **Spice Cloud Platform**.
+  <img width="400" src="/img/tableau/tableau-spice-dialog.png" alt="Spice Tableau Connection Dialog" />
+
+4. Click **Sign In**
+
+## Working with Spice datasets
 
-<img width="800" src="/img/tableau/tableau-custom-sql.png" />
+After establishing a connection, Spice datasets appear under their respective schemas, with the default schema being `spice.public`.  When writing queries, use the `PostgreSQL` dialect, as Spice is built on this standard.
 
-<img width="800" src="/img/tableau/tableau-spice-chart.png" />
+<img width="800" src="/img/tableau/tableau-spice-example.png" alt="Spice Tableau Example"/>