Skip to content

Commit 28a7189

Browse files
committed
docs(looker-studio): enhance Columnar readme with authentication and configuration visuals
- Added images for the authentication screen, database scope view configuration, field customization, and report creation in Looker Studio. - Expanded instructions to guide users through the setup process after adding the Couchbase Columnar connector. - Improved clarity on the steps required to create reports using TAV-backed fields. Files: - tutorial/markdown/connectors/looker-studio/columnar/readme.md
1 parent 1c91d74 commit 28a7189

File tree

5 files changed

+16
-2
lines changed

5 files changed

+16
-2
lines changed

tutorial/markdown/connectors/looker-studio/columnar/readme.md

Lines changed: 16 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,10 @@ When adding the data source, provide:
4949

5050
The connector validates credentials by running a lightweight test query (`SELECT 1 AS test;`).
5151

52+
When you add the Couchbase Columnar connector in Looker Studio, you'll see the authentication screen:
53+
54+
![Authentication Screen](step-0.png "Couchbase Columnar connector authentication screen in Looker Studio")
55+
5256
## Create Tabular Analytics Views (TAVs) in Capella (Required)
5357

5458
Before connecting, create Tabular Analytics Views in Capella:
@@ -117,6 +121,9 @@ What runs:
117121
- Data: Your exact custom query as entered
118122
- Schema: `SELECT array_infer_schema((your_custom_query)) AS inferred_schema;`
119123

124+
After authentication, configure the connector by selecting your database, scope, and view:
125+
126+
![Database Scope View Configuration](step-1.png "Configuring database, scope, and view selection in Looker Studio")
120127

121128
## Schema and Field Types
122129

@@ -128,6 +135,10 @@ What runs:
128135

129136
> **⚠️ Schema Inference Notes**: Field types are inferred from sampled data and may miss variations (e.g., fields containing both text and numbers). Some fields present in unsampled documents may not be detected. If schema inference fails, ensure your TAV contains data and try adding a `LIMIT` clause to sample fewer rows.
130137
138+
Once your schema is configured, you can customize the fields in your Looker Studio dashboard:
139+
140+
![Field Configuration in Dashboard](step-2.png "Configuring fields in Looker Studio dashboard before creating reports")
141+
131142
## Data Retrieval
132143

133144
- Only requested fields are projected. For nested fields, the connector fetches the required base fields and extracts values server-side within the Apps Script environment.
@@ -149,9 +160,12 @@ What runs:
149160

150161
## Next Steps
151162

163+
Once your connector is configured and fields are set up, create reports by dragging and dropping tables from the side pane onto the main canvas:
164+
165+
![Creating Reports in Looker Studio](step-3.png "Creating reports by dragging and dropping tables onto the canvas in Looker Studio")
166+
152167
- Build charts in Looker Studio using your TAV-backed fields.
153168
- Iterate on Views/queries to shape the dataset for analytics.
154-
155-
> **Note**: Screenshots and step-by-step visual guides for creating charts and configuring the connector will be added to this section.
169+
- Explore the rich visualization options available in Looker Studio to create compelling dashboards from your Columnar data.
156170

157171

312 KB
Loading
92.9 KB
Loading
121 KB
Loading
233 KB
Loading

0 commit comments

Comments
 (0)