You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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
Copy file name to clipboardExpand all lines: tutorial/markdown/connectors/looker-studio/columnar/readme.md
+21-19Lines changed: 21 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,11 +2,11 @@
2
2
# frontmatter
3
3
path: "/tutorial-looker-studio-columnar"
4
4
# 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)
7
7
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
10
10
- Learn authentication, configuration, schema inference, and troubleshooting
11
11
content_type: tutorial
12
12
filter: connectors
@@ -27,14 +27,14 @@ length: 20 Mins
27
27
28
28
## Overview
29
29
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.
31
31
32
32
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.
33
33
34
34
## Prerequisites
35
35
36
36
- 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.
38
38
- Network access from Looker Studio to your Columnar host.
39
39
40
40
## Authentication
@@ -48,30 +48,32 @@ When adding the data source, provide:
48
48
49
49
The connector validates credentials by running a lightweight test query (`SELECT 1 AS test;`).
50
50
51
-
## Create Views in Capella (Required)
51
+
## Create Tabular Analytics Views (TAVs) in Capella (Required)
52
52
53
-
Before connecting, create views in Capella Columnar Workbench:
53
+
Before connecting, create Tabular Analytics Views in Capella:
54
54
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:
57
57
58
58
```sql
59
-
CREATEVIEWmy_airportsAS
60
-
SELECT airportname, city, country
59
+
SELECT airportname AS airportname,
60
+
city AS city,
61
+
country AS country
61
62
FROM`travel-sample`.`inventory`.`airport`
62
63
WHERE country ='United States';
63
64
```
64
65
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).
- Couchbase Database, Scope, View: Selected from dropdowns populated from metadata.
77
79
- Maximum Rows: Optional limit for returned rows; leave blank for no limit.
@@ -81,7 +83,7 @@ What runs:
81
83
- Data: `SELECT <requested fields or *> FROM \`database\`.\`scope\`.\`view\`[LIMIT n]`
82
84
- Schema: `SELECT array_infer_schema((SELECT VALUE t FROM \`database\`.\`scope\`.\`view\`[LIMIT n])) AS inferred_schema;`
83
85
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.
85
87
86
88
## Schema and Field Types
87
89
@@ -99,7 +101,7 @@ What runs:
99
101
100
102
## Tips and Best Practices
101
103
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.
103
105
- Keep datasets scoped and use `LIMIT` while exploring.
104
106
105
107
## Troubleshooting
@@ -110,11 +112,11 @@ What runs:
110
112
111
113
## Future Scope (Prototype)
112
114
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.
114
116
115
117
## Next Steps
116
118
117
-
- Build charts in Looker Studio using your View-backed fields.
119
+
- Build charts in Looker Studio using your TAV-backed fields.
118
120
- Iterate on Views/queries to shape the dataset for analytics.
0 commit comments