|
| 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