# How Sigma works

Learn what you can do with Sigma.

Les données disponibles dans Sigma ne sont accessibles qu’en lecture seule. Les requêtes ne peuvent pas modifier des données existantes ou créer de nouvelles transactions.

[Sigma](https://dashboard.stripe.com/sigma/queries) provides an interactive SQL environment in the Stripe Dashboard for querying your transactional data. Use Sigma to create custom financial reports for accounting and reconciliation, build reports from pre-configured templates, and track key metrics. All data is read-only and includes information about payments, subscriptions, customers, payouts, and so on.

## Try Sigma for free in sandboxes 

Sigma is free to use in [sandboxes](https://docs.stripe.com/sandboxes.md), with no usage limits. You can run unlimited queries against your test data at no cost. Activities in sandboxes don’t count toward your charge-based entitlement and don’t incur any fees. Use sandboxes to explore Sigma’s capabilities before committing to a paid plan.

## Create a custom report 

Reports give you the data required for your accounting and reconciliation workflows. To create a report, query the assistant or write your own report with SQL. The reports you generate can differ from those you generate in the Stripe Dashboard in the following ways:

- **Disponibilité des données :** pour les rapports financiers, vous pouvez trouver le jour le plus récent des données disponibles en sélectionnant **Mois en cours** ou en ouvrant le calendrier du sélecteur de dates. Dans Sigma, le paramètre `data_load_time` fournit l’horodatage de disponibilité des données.

- **Fuseau horaire :** les rapports financiers du Dashboard Stripe filtrent par défaut les rapports de manière à afficher le fuseau horaire local, mais vous pouvez choisir d’afficher plutôt le fuseau horaire UTC. Sigma filtre les modèles en fonction du fuseau horaire UTC.

- \**Plage de dates : ** une plage de dates sélectionnées pour les rapports financiers du Dashboard Stripe, par exemple du 13 au 14 janvier, qui permet de filtrer les rapports entre le 13 janvier à 00:00:00 et le 14 janvier à 23:59:59. Pour les modèles Sigma, cette même plage de dates filtre les rapports entre 13 janvier à 00:00:00 au 14 janvier à 23:59:59.

- **Devise :** dans le Dashboard Stripe, les données des rapports financiers sont toujours filtrées selon une seule devise. Par défaut, les modèles de rapport Sigma renvoient toutes les devises. Vous pouvez ajouter une clause `WHERE` à votre requête Sigma pour qu’elle ne renvoie qu’une seule devise.

- \**Métadonnées : ** les rapports financiers vous permettent d’inclure des métadonnées. Les modèles Sigma ne les incluent pas. Vous pouvez ajouter des métadonnées à vos rapports en suivant le modèle Sigma `Metadata to column`.

Reports follow the same availability rules as the Stripe Dashboard. Payout Reconciliation reports are only available for users with the **Automatic payouts** setting enabled, and Connect variants of reports are only available for users on [Stripe Connect](https://docs.stripe.com/connect.md).

### Report templates 

You can also create a report using a [template](https://docs.stripe.com/data/write-queries.md#templates). By default, these reports run on the last completed month that all data is available for. To change the dates, make a copy of the template and edit the report date intervals. Use the listed templates to generate their related reports and their connected variants:

| Report group                                  | Sigma template name                          | API report type                           |
| --------------------------------------------- | -------------------------------------------- | ----------------------------------------- |
| **Balance report**                            | Itemized balance change from activity report | `balance_change_from_activity.itemized.3` |
| Itemized payouts                              | `payouts.itemized.3`                         |
| **Payout reconciliation report**              | Detailed payout reconciliation               | `payout_reconciliation.itemized.5`        |
| Itemized ending balance reconciliation report | `ending_balance_reconciliation.itemized.4`   |

## Create and manage metrics 

Create metrics from your Sigma reports and organize them in [metric groups](https://dashboard.stripe.com/custom-metrics) to monitor your most important metrics daily. Edit the [Sigma chart](https://docs.stripe.com/data/write-queries.md#view-download-query-results) on your metric to customize the metric preview. Metric groups that don’t have a chart enabled display the number of rows in the report.
![Illustre les groupes de rapports personnalisés Sigma](https://b.stripecdn.com/docs-statics-srv/assets/custom-reports.537d49b1fa1765a58d7237cf251d4a01.png)

Vous pouvez ajouter jusqu’à 20 rapports Sigma sur tous les groupes d’indicateurs. Seul l’auteur du groupe d’indicateurs peut le modifier ou le supprimer. Si vous supprimez un groupe d’indicateurs, cela n’a pas d’impact sur les rapports de ce groupe.

## Unsubscribing from Sigma 

Si vous disposez actuellement d’un abonnement Sigma actif et que vous souhaitez l’annuler, accédez à vos [paramètres Sigma](https://dashboard.stripe.com/settings/sigma) et cliquez sur **Annuler l’abonnement Stripe Sigma**. Vous pouvez continuer à utiliser Sigma jusqu’à la fin du cycle de facturation, après quoi l’abonnement prendra fin.

## See also

- [Query transaction data](https://docs.stripe.com/data/query-transactions.md)
- [Query Billing data](https://docs.stripe.com/data/query-billing-data.md)
- [Query connected account data](https://docs.stripe.com/data/query-connect-data.md)
- [Query all fees data](https://docs.stripe.com/data/query-all-fees-data.md)