Skip to content

Commit c7c55b4

Browse files
committed
docs(looker-studio): update Columnar readme to reflect Tabular Analytics Views (TAVs)
- Revised title and description to specify TAVs instead of views. - Updated instructions and prerequisites to clarify the use of TAVs in Capella. - Adjusted sections throughout the document to consistently reference TAVs for improved clarity. Files: - tutorial/markdown/connectors/looker-studio/columnar/readme.md
1 parent aecc97e commit c7c55b4

File tree

1 file changed

+21
-19
lines changed
  • tutorial/markdown/connectors/looker-studio/columnar

1 file changed

+21
-19
lines changed

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

Lines changed: 21 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,11 @@
22
# frontmatter
33
path: "/tutorial-looker-studio-columnar"
44
# title and description do not need to be added to markdown, start with H2 (##)
5-
title: Looker Studio with Couchbase Columnar (Views-only)
6-
short_title: Columnar (Views-only)
5+
title: Looker Studio with Couchbase Columnar (Views-only with Tabular Analytics Views)
6+
short_title: Columnar (Views-only TAVs)
77
description:
8-
- Connect Google Looker Studio to Couchbase Columnar using views only
9-
- Create views in Capella and use them as stable, optimized datasets
8+
- Connect Google Looker Studio to Couchbase Columnar using Tabular Analytics Views (TAVs) only
9+
- Create Tabular Analytics Views in Capella and use them as stable, optimized datasets
1010
- Learn authentication, configuration, schema inference, and troubleshooting
1111
content_type: tutorial
1212
filter: connectors
@@ -27,14 +27,14 @@ length: 20 Mins
2727

2828
## Overview
2929

30-
This is a views-only connector for Google Looker Studio and Couchbase Columnar. It exclusively accesses data through views in Couchbase Capella. Create one or more views first, then connect Looker Studio to those views for analysis.
30+
This is a views-only connector for Google Looker Studio and Couchbase Columnar. It exclusively reads from Couchbase Tabular Analytics Views (TAVs) in Capella. Create one or more TAVs first, then connect Looker Studio to those views for analysis.
3131

3232
The connector authenticates with Basic Auth to the Columnar API (`/api/v1/request`) and infers schema automatically using `array_infer_schema` so Looker Studio fields are created with reasonable types.
3333

3434
## Prerequisites
3535

3636
- A Couchbase Columnar deployment reachable from Looker Studio.
37-
- A database user with permissions to read from the target Views and execute queries.
37+
- A database user with permissions to read from the target Tabular Analytics Views (TAVs) and execute queries.
3838
- Network access from Looker Studio to your Columnar host.
3939

4040
## Authentication
@@ -48,30 +48,32 @@ When adding the data source, provide:
4848

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

51-
## Create Views in Capella (Required)
51+
## Create Tabular Analytics Views (TAVs) in Capella (Required)
5252

53-
Before connecting, create views in Capella Columnar Workbench:
53+
Before connecting, create Tabular Analytics Views in Capella:
5454

55-
1. Open Capella, navigate to the Columnar tab, and launch the Workbench for your cluster.
56-
2. Create a view using SQL++:
55+
1. Open your Capella cluster, go to the Analytics tab, and launch the Analytics Workbench.
56+
2. Prepare a SQL++ query that returns a flat, tabular result (flatten nested objects where needed). For example:
5757

5858
```sql
59-
CREATE VIEW my_airports AS
60-
SELECT airportname, city, country
59+
SELECT airportname AS airportname,
60+
city AS city,
61+
country AS country
6162
FROM `travel-sample`.`inventory`.`airport`
6263
WHERE country = 'United States';
6364
```
6465

65-
- Replace names as needed. Views are stable datasets optimized for BI.
66-
- For more, see the Couchbase docs on [Views and Tabular Views](https://docs.couchbase.com/columnar/sqlpp/5a_views.html) and on [Buckets, Scopes, and Collections](https://docs.couchbase.com/cloud/clusters/data-service/about-buckets-scopes-collections.html).
66+
3. Run the query, then click Save as View → Annotate for Tabular View. Define the schema (column names, data types, and primary keys) and save with a descriptive name.
67+
68+
- For details, see [Tabular Analytics Views](https://docs.couchbase.com/columnar/query/views-tavs.html) and [Buckets, Scopes, and Collections](https://docs.couchbase.com/cloud/clusters/data-service/about-buckets-scopes-collections.html).
6769

6870
## Configuration
6971

7072
Choose your mode in the configuration screen:
7173

7274
- Configuration Mode: `By View` (views-only connector).
7375

74-
### Mode: By View
76+
### Mode: By View (TAV)
7577

7678
- Couchbase Database, Scope, View: Selected from dropdowns populated from metadata.
7779
- Maximum Rows: Optional limit for returned rows; leave blank for no limit.
@@ -81,7 +83,7 @@ What runs:
8183
- Data: `SELECT <requested fields or *> FROM \`database\`.\`scope\`.\`view\` [LIMIT n]`
8284
- Schema: `SELECT array_infer_schema((SELECT VALUE t FROM \`database\`.\`scope\`.\`view\` [LIMIT n])) AS inferred_schema;`
8385

84-
> Note: This connector does not query collections directly and does not accept custom queries. It reads through views only.
86+
> Note: This connector does not query collections directly and does not accept custom queries. It reads through Tabular Analytics Views (TAVs) only.
8587
8688
## Schema and Field Types
8789

@@ -99,7 +101,7 @@ What runs:
99101

100102
## Tips and Best Practices
101103

102-
- Prefer views for BI tooling; they offer a stable, optimized interface.
104+
- Prefer Tabular Analytics Views for BI tooling; they offer a stable, optimized interface.
103105
- Keep datasets scoped and use `LIMIT` while exploring.
104106

105107
## Troubleshooting
@@ -110,11 +112,11 @@ What runs:
110112

111113
## Future Scope (Prototype)
112114

113-
- Collections and custom query support are in prototype and not available in this views-only connector. As support expands, you’ll be able to query collections directly from Looker Studio in addition to views.
115+
- Collections and custom query support are in prototype and not available in this views-only connector. As support expands, you’ll be able to query collections directly from Looker Studio in addition to TAVs.
114116

115117
## Next Steps
116118

117-
- Build charts in Looker Studio using your View-backed fields.
119+
- Build charts in Looker Studio using your TAV-backed fields.
118120
- Iterate on Views/queries to shape the dataset for analytics.
119121

120122

0 commit comments

Comments
 (0)