Skip to content

Commit 7cb1229

Browse files
authored
docs: Microsoft Fabric support (#7754)
* docs: Microsoft Fabric support * Correct server name * Update
1 parent c63c044 commit 7cb1229

File tree

3 files changed

+120
-2
lines changed

3 files changed

+120
-2
lines changed

docs/pages/product/configuration/data-sources.mdx

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,11 @@ sources][ref-config-multi-data-src] out of the box.
3434
imageUrl="https://static.cube.dev/icons/databricks.svg"
3535
title="Databricks"
3636
/>
37+
<GridItem
38+
url="data-sources/ms-fabric"
39+
imageUrl="https://static.cube.dev/icons/ms-fabric-light.svg"
40+
title="Microsoft Fabric"
41+
/>
3742
<GridItem
3843
url="data-sources/clickhouse"
3944
imageUrl="https://static.cube.dev/icons/clickhouse.svg"
@@ -87,7 +92,7 @@ sources][ref-config-multi-data-src] out of the box.
8792
<GridItem
8893
url="data-sources/ms-sql"
8994
imageUrl="https://static.cube.dev/icons/ms-sql.svg"
90-
title="MS SQL"
95+
title="Microsoft SQL Server"
9196
/>
9297
<GridItem
9398
url="data-sources/mysql"

docs/pages/product/configuration/data-sources/_meta.js

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,8 +11,9 @@ module.exports = {
1111
"hive": "Hive / SparkSQL",
1212
"ksqldb": "ksqlDB",
1313
"materialize": "Materialize",
14+
"ms-fabric": "Microsoft Fabric",
15+
"ms-sql": "Microsoft SQL Server",
1416
"mongodb": "MongoDB",
15-
"ms-sql": "MS SQL Server",
1617
"mysql": "MySQL",
1718
"oracle": "Oracle",
1819
"postgres": "Postgres",
Lines changed: 112 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,112 @@
1+
# Microsoft Fabric
2+
3+
[Microsoft Fabric][link-fabric] is an all-in-one analytics solution for
4+
enterprises. It offers a comprehensive suite of services, including a
5+
data warehouse.
6+
7+
<SuccessBox>
8+
9+
Microsoft Fabric support is available in Cube Cloud on
10+
[Enterprise Premier](https://cube.dev/pricing) tier. [Contact
11+
us](https://cube.dev/contact) for details.
12+
13+
</SuccessBox>
14+
15+
## Setup
16+
17+
When creating a new deployment in Cube Cloud, at the <Btn>Set up a database
18+
connection</Btn> step, choose <Btn>Microsoft Fabric</Btn>.
19+
20+
<Screenshot src="https://ucarecdn.com/ecfef0be-8122-43c1-acca-7e9a5806b6fb/"/>
21+
22+
Then, provide the <Btn>JDBC URL</Btn> connection string in the following
23+
format. See below for tips on filling in `<SERVER_NAME>`, `<DATABASE_NAME>`,
24+
`<AUTH_TYPE>`, `<USER_NAME>`, and `<PASSWORD>`.
25+
26+
```
27+
jdbc:sqlserver://;serverName=<SERVER_NAME>.datawarehouse.pbidedicated.windows.net;database=<DATABASE_NAME>;encrypt=true;Authentication=<AUTH_TYPE>;UserName=<USER_NAME>;Password=<PASSWORD>
28+
```
29+
30+
Optionally, fill in <Btn>Database</Btn> if you'd like to override the database
31+
name from the JDBC URL.
32+
33+
### Server and database name
34+
35+
To obtain your data warehouse server name and database name, navigate to your
36+
data warehouse in Microsoft Fabric and click on the cog icon to open
37+
<Btn>Settings</Btn>:
38+
39+
<Screenshot
40+
src="https://ucarecdn.com/ed1b2916-ac3e-4493-8eee-e2fd5dd89dbc/"
41+
highlight="inset(5% 79% 76% 5% round 10px)"
42+
/>
43+
44+
On the <Btn>About</Btn> page, you can find the database name (`<DATABASE_NAME>`)
45+
under <Btn>Name</Btn> and the server name (`<SERVER_NAME>`) under
46+
<Btn>SQL connection string</Btn>:
47+
48+
<Screenshot
49+
src="https://ucarecdn.com/7818f783-4bd6-431c-87dd-c5169232c91b/"
50+
highlight="inset(1% 1% 30% 23% round 10px)"
51+
/>
52+
53+
### Authentication
54+
55+
Microsoft Fabric supports two [authentication types][link-fabric-auth]:
56+
57+
* Use `ActiveDirectoryPassword` as `<AUTH_TYPE>` to connect using a
58+
Microsoft Entra principal name and password. Provide principal name as
59+
`<USER_NAME>` and password as `<PASSWORD>`.
60+
* Use `ActiveDirectoryServicePrincipal` as `<AUTH_TYPE>` to connect
61+
using the client ID and secret of a service principal identity. Provide
62+
client ID as `<USER_NAME>` and secet as `<PASSWORD>`.
63+
64+
## Pre-Aggregation Feature Support
65+
66+
### count_distinct_approx
67+
68+
Measures of type
69+
[`count_distinct_approx`][ref-schema-ref-types-formats-countdistinctapprox] can
70+
not be used in pre-aggregations when using Microsoft Fabric as a source
71+
database.
72+
73+
## Pre-Aggregation Build Strategies
74+
75+
<InfoBox>
76+
77+
To learn more about pre-aggregation build strategies, [head
78+
here][ref-caching-using-preaggs-build-strats].
79+
80+
</InfoBox>
81+
82+
| Feature | Works with read-only mode? | Is default? |
83+
| ------------- | :------------------------: | :---------: |
84+
| Simple |||
85+
| Batching | - | - |
86+
| Export Bucket | - | - |
87+
88+
By default, Microsoft Fabric uses a [simple][self-preaggs-simple] strategy
89+
to build pre-aggregations.
90+
91+
### Simple
92+
93+
No extra configuration is required to configure simple pre-aggregation builds
94+
for Microsoft Fabric.
95+
96+
### Batching
97+
98+
Microsoft Fabric does not support batching.
99+
100+
### Export Bucket
101+
102+
Microsoft Fabric does not support export buckets.
103+
104+
[link-fabric]: https://www.microsoft.com/en-us/microsoft-fabric/
105+
[link-fabric-auth]: https://learn.microsoft.com/en-us/sql/connect/jdbc/setting-the-connection-properties?view=sql-server-ver16#properties
106+
[ref-caching-using-preaggs-build-strats]:
107+
/product/caching/using-pre-aggregations#pre-aggregation-build-strategies
108+
[ref-recipe-enable-ssl]:
109+
/guides/recipes/data-sources/using-ssl-connections-to-data-source
110+
[ref-schema-ref-types-formats-countdistinctapprox]:
111+
/reference/data-model/types-and-formats#count_distinct_approx
112+
[self-preaggs-simple]: #simple

0 commit comments

Comments
 (0)