Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Connectez-vous à une source de données Snowflake
<a name="snowflake-datasource-for-AMG"></a>

 Avec la source de données Snowflake Enterprise, vous pouvez visualiser vos données Snowflake à côté de toutes vos autres sources de données dans Grafana, ainsi que les données de log et de métrique en contexte. Cette source de données inclut un puissant éditeur de requêtes à saisie anticipée, prend en charge les annotations complexes, définit des seuils d'alerte, contrôle l'accès et les autorisations, etc. 

**Note**  
Cette source de données est réservée à Grafana Enterprise. Pour de plus amples informations, veuillez consulter [Gérer l'accès aux plug-ins d'entreprise](upgrade-to-enterprise-plugins.md).  
En outre, dans les espaces de travail qui prennent en charge la version 9 ou une version plus récente, cette source de données peut nécessiter l'installation du plug-in approprié. Pour de plus amples informations, veuillez consulter [Étendez votre espace de travail avec des plugins](grafana-plugins.md).

## Présentation de
<a name="snowflake-overview"></a>

### Qu'est-ce que Snowflake ?
<a name="what-is-snowflake"></a>

 Snowflake propose un service de stockage et d'analyse de données basé sur le cloud, généralement appelé « entrepôt de données en tant que service », qui offre une solution pour l'entreposage de données, les lacs de données, l'ingénierie des données, la science des données, le développement d'applications de données et le partage de données. Au cours des dernières années, Snowflake a gagné en popularité en raison de sa capacité à stocker et à analyser des données à un prix abordable à l'aide de matériel et de logiciels basés sur le cloud ; elle a récemment atteint son apogée avec la plus grande introduction en bourse de logiciels jamais réalisée. Aujourd'hui, de nombreuses entreprises utilisent Snowflake comme base de données principale pour stocker des données applicatives et commerciales telles que le nombre de transactions, les sessions utilisateur actives et même les séries chronologiques et les données métriques. 

### Tirer le meilleur parti de Snowflake et Amazon Managed Grafana
<a name="making-the-most-of-snowflake-and-AMG"></a>

 **Visualisez les données Snowflake sans les déplacer : l'**architecture unique de Grafana interroge les données directement là où elles se trouvent plutôt que de les déplacer et de payer pour un stockage et une ingestion redondants. 

 **Composez des panneaux à partir de sources variées :** grâce à des tableaux de bord prédéfinis et personnalisés, regroupez des données provenant de nombreuses sources de données différentes dans un seul panneau de verre. 

 **Transformation et calcul au niveau de l'utilisateur** : les utilisateurs peuvent transformer les données et exécuter divers calculs sur les données qu'ils consultent, ce qui nécessite moins de préparation des données. 

 **Combinez, calculez et visualisez dans des panneaux** : créez des panneaux de sources de données mixtes qui affichent des données connexes provenant de Snowflake et d'autres sources. 

### Caractéristiques
<a name="snowflake-features"></a>

 Éditeur de **requêtes : l'éditeur** de requêtes est un éditeur d'autocomplétion SQL intelligent qui vous permet de visualiser des séries chronologiques ou des données de tables, de gérer les erreurs de syntaxe SQL et de compléter automatiquement les mots clés SQL de base. 

 **Autorisations relatives aux sources de données** : contrôlez qui peut afficher ou interroger les données Snowflake dans Grafana 

 **Annotations :** Superposez les événements Snowflake sur n'importe quel graphe Grafana, pour corréler les événements avec d'autres données du graphique 

 **Alertes : définissez des** alertes basées sur des banques de statistiques dans Snowflake 

 **Variables pour les requêtes :** créez des variables de modèle dans Grafana à partir des données Snowflake, et incluez des variables dans les requêtes Snowflake pour créer des tableaux de bord interactifs. 

 **Multi-metric requêtes :** écrivez une seule requête qui renvoie plusieurs métriques, chacune dans sa propre colonne 

## Commencez avec le plugin Snowflake
<a name="get-started-with-the-snowflake-plugin"></a>

 Voici cinq étapes rapides pour démarrer avec le plugin Snowflake dans Grafana : 

### Étape 1 : configurer la source de données Snowflake
<a name="set-up-the-snowflake-data-source"></a>

 Pour configurer la source de données, choisissez **Configuration**, **Sources de données**, **Ajouter une source de données**, Snowflake. 

 Ajoutez vos informations d'authentification et la source de données est prête à être consultée \! 

 Les champs de configuration suivants sont disponibles. 


|  Nom  |  Description  | 
| --- | --- | 
|  Compte  |  Compte pour Snowflake.  | 
|  Nom d’utilisateur  |  Nom d'utilisateur du compte de service.  | 
|  Mot de passe  |  Mot de passe pour le compte de service.  | 
|  Schéma (facultatif)  |  Définit un schéma par défaut pour les requêtes.  | 
|  Entrepôt (facultatif)  |  Définit un entrepôt par défaut pour les requêtes.  | 
|  Base de données (facultatif)  |  Définit une base de données par défaut pour les requêtes.  | 
|  Rôle (facultatif)  |  Assume un rôle pour les requêtes.  | 

### Étape 2 : Rédiger des requêtes pour vos données Snowflake
<a name="write-queries-for-your-snowflake-data"></a>

 Créez un panneau dans un tableau de bord et sélectionnez une source de données Snowflake pour commencer à utiliser l'éditeur de requêtes. 
+  La date et l'heure peuvent apparaître n'importe où dans la requête tant qu'elles sont incluses. 
+  Une colonne numérique doit être incluse. Il peut s'agir d'une agrégation ou d'une int/float colonne. 
+  Vous pouvez éventuellement inclure des colonnes de chaîne pour créer des séries de données distinctes, si les données de vos séries chronologiques sont mises en forme pour différentes mesures. 

#### Disposition d'une requête Snowflake
<a name="layout-of-a-snowflake-query"></a>

```
select
  <time_column>,
  <any_numerical_column>
  <other_column_1>,
  <other_column_2>,
  <...>
from
  <any_table>
where
  $__timeFilter(<time_column>) // predefined where clause for time range
  and $<custom_variable> = 1 // custom variables start with dollar sign
```

#### Format de requête SQL pour les séries chronologiques groupées par intervalle
<a name="sql-query-format-for-timeseries-group-by-interval"></a>

```
select
  $__timeGroup(created_ts, '1h'), // group time by interval of 1h
  <time_column>, 
  <any_numerical_column>,
  <metric_column>
from
  <any_table>
where
  $__timeFilter(<time_column>) // predefined where clause for time range
  and $<custom_variable> = 1 // custom variables start with dollar sign
group by <time_column>
```

#### Format de requête SQL pour les tables
<a name="sql-query-format-for-tables"></a>

```
select
  <time_column>, // optional if result format option is table
  <any_column_1>
  <any_column_2>
  <any_column_3>
from
  <any_table>
where
  $__timeFilter(time_column) // macro for time range, optional if format as option is table
  and $<custom_variable> = 1 // custom variables start with dollar sign
```

### Étape 3 : Création et utilisation de variables de modèle
<a name="snowflake-create-and-use-template-variables"></a>

#### Utilisation de variables de modèle
<a name="snowflake-using-template-variables-1"></a>

 Vous pouvez inclure des variables de modèle dans les requêtes, comme illustré dans l'exemple suivant. 

```
 select
   <column>
 from 
   <table>
 WHERE column >= '$variable'
```

 L'exemple suivant montre l'utilisation de variables à valeurs multiples dans une requête. 

```
select
  <column>
from 
  <table>
WHERE <column> regexp '${variable:regex}'
```

#### Utilisation de la source de données Snowflake pour créer des variables
<a name="using-the-snowflake-datasource-to-create-variables"></a>

 Dans les paramètres du tableau de bord, choisissez **Variables**, puis **Nouveau**. 

 À l'aide du type de variable « Requête », sélectionnez la source de données Snowflake comme « Source de données ». 

**Important**  
 Assurez-vous de ne sélectionner qu'une seule colonne dans votre requête variable. 

 Exemple : 

```
SELECT DISTINCT query_type from account_usage.query_history;
```

 vous donnera les variables suivantes : 

```
All DESCRIBE USE UNKNOWN GRANT SELECT CREATE DROP SHOW
```

### Étape 4 : configurer une alerte
<a name="snowflake-set-up-an-alert"></a>

 Vous pouvez définir des alertes sur des métriques spécifiques de Snowflake ou sur des requêtes que vous avez créées. 

 Cliquez sur le bouton de l'onglet d'alerte dans l'éditeur de requêtes, puis sélectionnez **Créer une alerte**. 

### Étape 5. Création d'une annotation
<a name="snowflake-create-an-annotation"></a>

 Les annotations vous permettent de superposer des événements sur un graphique. 

 Pour créer une annotation, dans les paramètres du tableau de bord, choisissez **Annotations** et **Nouveau**, puis sélectionnez Snowflake comme source de données. 

 Les annotations étant des événements, elles nécessitent au moins une colonne temporelle et une colonne pour décrire l'événement. 

 L'exemple de code suivant montre une requête pour annoter toutes les connexions échouées à Snowflake. 

```
SELECT
  EVENT_TIMESTAMP as time,
  EVENT_TYPE,
  CLIENT_IP
FROM ACCOUNT_USAGE.LOGIN_HISTORY
WHERE $__timeFilter(time) AND IS_SUCCESS!='YES'
ORDER BY time ASC;
```

 Et 
+  heure : `TIME` 
+  titre : `EVENT_TYPE` 
+  texte : `CLIENT_IP` 

 Cela superposera les annotations de toutes les connexions échouées à Snowflake sur les panneaux de votre tableau de bord. 

## Fonctionnalités supplémentaires
<a name="additional-functionality"></a>

### Utilisation du champ Nom d'affichage
<a name="snowflake-using-display-name"></a>

 Ce plugin utilise le champ Nom d'affichage dans l'onglet Champ du panneau Options pour raccourcir ou modifier une clé de légende en fonction de son nom, de ses étiquettes ou de ses valeurs. D'autres sources de données utilisent des `alias` fonctionnalités personnalisées pour modifier les clés de légende, mais la fonction Nom d'affichage est un moyen plus cohérent de le faire. 

### Autorisations relatives aux sources de données
<a name="snowflake-data-source-permissions"></a>

 Limitez l'accès à Snowflake en choisissant l'onglet **Autorisations** sur la page de configuration de la source de données pour activer les autorisations de source de données. Sur la page des autorisations, les administrateurs peuvent activer les autorisations et restreindre les autorisations de requête à des utilisateurs et à des équipes spécifiques. 

### Comprenez vos données de facturation et d'utilisation de Snowflake
<a name="understand-your-snowflake-billing-and-usage-data"></a>

 Dans la source de données Snowflake, vous pouvez importer un tableau de bord de facturation et d'utilisation qui affiche des informations utiles sur la facturation et l'utilisation. 

 Ajoutez le tableau de bord dans la page de configuration de la source de données Snowflake : 

 Ce tableau de bord utilise la base de données ACCOUNT\_USAGE et nécessite que le demandeur ait le rôle ACCOUNTADMIN. Pour le faire en toute sécurité, créez une nouvelle source de données Grafana dont l'utilisateur possède le rôle ACCOUNTADMIN. Sélectionnez ensuite cette source de données dans les variables.