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 à vos données grâce à des intégrations et à des ensembles de données
<a name="connecting-to-data-examples"></a>

Vous pouvez connecter Amazon Quick Sight à différents types de sources de données. Cela inclut les données résidant dans des applications Software-as-a-Service (SaaS), les fichiers plats stockés dans des compartiments Amazon S3, les données provenant de services tiers tels que Salesforce et les résultats de requêtes d'Athena. Utilisez les exemples suivants pour en savoir plus sur les exigences relatives à la connexion à de sources de données spécifiques. 

**Topics**
+ [Créer un jeu de données à l’aide des données Amazon Athena](create-a-data-set-athena.md)
+ [Utilisation d'Amazon OpenSearch Service avec Amazon Quick Sight](connecting-to-os.md)
+ [Création d’un jeu de données à partir de fichiers Amazon S3](create-a-data-set-s3.md)
+ [Création d’une source de données en utilisant Apache Spark](create-a-data-source-spark.md)
+ [Utilisation de Databricks dans Quick Sight](quicksight-databricks.md)
+ [Création d’un jeu de données à l’aide de Google BigQuery](quicksight-google-big-query.md)
+ [Création d’un jeu de données à l’aide d’une source de données Google Sheets](create-a-dataset-google-sheets.md)
+ [Création d’un jeu de données à partir d’une source de données Apache Impala](create-a-dataset-impala.md)
+ [Création d’un jeu de données à partir d’un fichier Microsoft Excel](create-a-data-set-excel.md)
+ [Création d’une source de données en utilisant Presto](create-a-data-source-presto.md)
+ [Utilisation de Snowflake avec Amazon Quick Sight](connecting-to-snowflake.md)
+ [Utilisation de Starburst avec Amazon Quick Sight](connecting-to-starburst.md)
+ [Création d’une source de données et d’un jeu de données à partir de sources SaaS](connecting-to-saas-data-sources.md)
+ [Création d’un jeu de données à partir de Salesforce](create-a-data-set-salesforce.md)
+ [Utilisation de Trino avec Amazon Quick Sight](connecting-to-trino.md)
+ [Création d’un jeu de données à partir d’un fichier texte local](create-a-data-set-file.md)
+ [Utilisation des données Amazon Timestream avec Amazon Quick Sight](using-data-from-timestream.md)

# Créer un jeu de données à l’aide des données Amazon Athena
<a name="create-a-data-set-athena"></a>

Utilisez la procédure suivante pour créer un jeu de données connecté aux données Amazon Athena ou aux données de requête fédérée Athena.

**Connexion à Amazon Athena**

1. Commencez par créer un nouveau jeu de données. Choisissez **Data** dans le volet de navigation de gauche.

1. Choisissez **Créer**, puis sélectionnez **Nouvel ensemble de données**.

1. 

   1. Pour utiliser un profil de connexion Athena existant (commun), choisissez la carte correspondant à la source de données existante que vous souhaitez utiliser. Choisissez **Select (Sélectionner)**. 

      Les cartes sont étiquetées avec l’icône de source de données Athena ainsi que le nom fourni par la personne qui a créé la connexion.

   1. Pour créer un nouveau profil de connexion Athena (moins courant), procédez comme suit :

      1. Choisissez **Nouvelle source de données**, puis choisissez la carte de source de données **Athena**.

      1. Choisissez **Suivant**.

      1. Pour **Nom de la source de données**, entrez un nom descriptif.

      1. Pour le **groupe de travail Athena**, choisissez votre groupe de travail.

      1. Choisissez **Valider la connexion** pour tester la connexion.

      1. Choisissez **Create data source**.

      1. (Facultatif) Sélectionnez un ARN de rôle IAM sous lequel les requêtes seront exécutées. 

1. Dans l’écran **Choisissez votre tableau**, effectuez les opérations suivantes :

   1. Pour **Catalogue**, choisissez l’une des valeurs suivantes :
      + Si vous utilisez Requête fédérée Athena, choisissez le catalogue que vous souhaitez utiliser.
      + Sinon, choisissez **AwsDataCatalog**.

   1. Sélectionnez l’une des méthodes suivantes :
      + Pour écrire une requête SQL, choisissez **Utiliser un code SQL personnalisé**. 
      + Pour choisir une base de données et un tableau, choisissez le catalogue qui contient vos bases de données dans le menu déroulant situé sous **Catalogue**. Choisissez ensuite une base de données dans le menu déroulant sous **Base de données** et choisissez un tableau dans la liste **Tableaux** qui apparaît pour votre base de données.

   Si vous ne disposez pas des autorisations appropriées, le message d’erreur suivant s’affiche : « Vous ne disposez pas des autorisations suffisantes pour vous connecter à ce jeu de données ou exécuter cette requête. » Contactez votre administrateur Quick pour obtenir de l'aide. Pour de plus amples informations, veuillez consulter [Autorisation des connexions à Amazon Athena](athena.md). 

1. Choisissez **Modifier/apercevoir des données**. 

1. Pour créer un jeu de données et analyser les données en utilisant le tableau, choisissez **Visualiser**. Pour de plus amples informations, veuillez consulter [Analyses et rapports : visualisation des données dans Amazon Quick Sight](working-with-visuals.md). 

# Utilisation d'Amazon OpenSearch Service avec Amazon Quick Sight
<a name="connecting-to-os"></a>

Vous trouverez ci-dessous comment vous connecter à vos données Amazon OpenSearch Service à l'aide d'Amazon Quick Sight.

## Création d'une nouvelle connexion à une source de données Quick Sight pour OpenSearch Service
<a name="create-connection-to-es"></a>

Vous trouverez ci-dessous comment vous connecter au OpenSearch service

Avant de continuer, Amazon Quick Sight doit être autorisé à se connecter à Amazon OpenSearch Service. Si les connexions ne sont pas activées, un message d’erreur s’affichera lorsque vous essaierez de vous connecter. Un administrateur de Quick Sight peut autoriser les connexions aux AWS ressources. 

**Pour autoriser Quick Sight à établir une connexion au OpenSearch Service**

1. Ouvrez le menu en cliquant sur l'icône de votre profil en haut à droite, puis choisissez **Gérer rapidement**. Si l'option **Manage Quick** ne s'affiche pas dans le menu de votre profil, demandez de l'aide à votre administrateur Amazon Quick.

1. Choisissez **Sécurité et autorisations**, **Ajouter ou supprimer**.

1. Activez l'option pour **OpenSearch**.

1. Choisissez **Mettre à jour**.

Une fois que le OpenSearch Service est accessible, vous créez une source de données afin que les utilisateurs puissent utiliser les domaines spécifiés.

**Pour vous connecter au OpenSearch service**

1. Commencez par créer un nouveau jeu de données. Choisissez **Data** dans le volet de navigation de gauche, puis choisissez **Create** and **New Dataset**.

1. Choisissez la carte de source de OpenSearch données **Amazon**.

1. Dans **Nom de la source de données**, entrez un nom descriptif pour votre connexion à la source de données du OpenSearch service, par exemple`OpenSearch Service ML Data`. Comme vous pouvez créer de nombreux ensembles de données à partir d'une connexion à OpenSearch Service, il est préférable de choisir un nom simple.

1. Pour **Type de connexion**, choisissez le réseau que vous souhaitez utiliser. Il peut s’agir d’un cloud privé virtuel (VPC) basé sur Amazon VPC ou d’un réseau public. La liste des VPCs contient les noms des connexions VPC, plutôt que VPC. IDs Ces noms sont définis par l'administrateur Quick. 

1. Pour **Domaine**, choisissez le domaine de OpenSearch service auquel vous souhaitez vous connecter. 

1. Choisissez **Valider la connexion** pour vérifier que vous pouvez vous connecter correctement au OpenSearch service.

1. Pour continuer, choisissez **Créer une source de données**.

1. Pour les **tableaux**, choisissez celui que vous souhaitez utiliser, puis sélectionnez **Sélectionner** pour continuer. 

1. Effectuez l’une des actions suivantes :
   + Pour importer vos données dans le moteur en mémoire Quick Sight (appeléSPICE), choisissez **Importer vers SPICE pour accélérer les analyses**. Pour plus d'informations sur la façon d'activer l'importation de OpenSearch données, consultez[Autoriser les connexions à Amazon Service OpenSearch](opensearch.md).
   + Pour permettre à Quick Sight d'exécuter une requête sur vos données à chaque fois que vous actualisez le jeu de données ou que vous utilisez l'analyse ou le tableau de bord, choisissez **Directly query your data**. 

     Pour activer l'actualisation automatique sur un tableau de bord publié qui utilise des données de OpenSearch service, le jeu de données de OpenSearch service doit utiliser une requête directe.

1. Choisissez **Modifier/apercevoir**, puis **Enregistrer** pour enregistrer votre jeu de données et le fermer.

## Gestion des autorisations pour les données OpenSearch de service
<a name="dataset-permissions-for-es"></a>

La procédure suivante décrit comment afficher, ajouter et révoquer des autorisations pour autoriser l'accès à la même source de données OpenSearch de service. Les personnes que vous ajoutez doivent être des utilisateurs actifs dans Quick Sight pour que vous puissiez les ajouter. 

**Modifier les autorisations sur une source de données**

1. Choisissez **Data** sur la gauche, puis faites défiler l'écran vers le bas pour trouver la carte de source de données correspondant à votre connexion Amazon OpenSearch Service. On pourrait utiliser l’exemple `US Amazon OpenSearch Service Data`.

1. Choisissez le jeu de OpenSearch données **Amazon**.

1. Sur la page de détails du jeu de données qui s’ouvre, sélectionnez l’onglet **Autorisations**.

   Une liste des autorisations actuelles s’affiche.

1. Pour ajouter des autorisations, choisissez **Ajouter des utilisateurs et des groupes**, puis procédez de la façon suivante :

   1. Ajoutez des utilisateurs ou des groupes pour leur permettre d’utiliser le même jeu de données.

   1. Lorsque vous avez terminé d’ajouter toutes les personnes que vous souhaitez ajouter, choisissez les **autorisations** que vous désirez appliquer.

1. (Facultatif) Pour modifier les autorisations, vous pouvez choisir **Visualiseur** ou **Propriétaire**. 
   + Choisissez **Visualiseur** pour autoriser l’accès en lecture.
   + Choisissez **Propriétaire** pour autoriser cet utilisateur à modifier, partager ou supprimer cet ensemble de données Quick Sight. 

1. (Facultatif) Pour révoquer les autorisations, choisissez **Révoquer l’accès**. Une fois que vous avez révoqué l’accès d’un utilisateur, celui-ci ne peut pas créer de nouveaux jeux de données à partir de cette source de données. Cependant, leurs jeux de données existants ont toujours accès à cette source de données.

1. Lorsque vous avez terminé, choisissez **Fermer**.

## Ajouter un nouveau jeu de données Quick Sight pour OpenSearch Service
<a name="create-dataset-using-es"></a>

Une fois que vous avez une connexion à une source de données existante pour OpenSearch Service, vous pouvez créer des ensembles de données OpenSearch Service à utiliser pour l'analyse. 

**Pour créer un ensemble de données à l'aide OpenSearch de Service**

1. Sur la page d'accueil, choisissez **Data**, **Create**, **New dataset**.

1. Faites défiler la page vers le bas jusqu'à la carte de source de données correspondant à votre connexion au OpenSearch service. Si vous avez de nombreuses sources de données, vous pouvez utiliser la barre de recherche en haut de la page pour trouver un correspondance partielle avec votre source de données.

1. Choisissez la carte de source de OpenSearch données **Amazon**, puis choisissez **Create data set**.

1. Pour **Tables**, choisissez l'index de OpenSearch service que vous souhaitez utiliser.

1. Choisissez **Modifier/apercevoir**.

1. Choisissez **Enregistrer** pour enregistrer et fermer le jeu de données. 

## Ajouter des données de OpenSearch service à une analyse
<a name="open-analysis-add-dataset-for-es"></a>

Une fois qu'un jeu OpenSearch de données de services est disponible, vous pouvez l'ajouter à une analyse Quick Sight. Avant de commencer, assurez-vous que vous disposez d'un ensemble de données existant contenant les données de OpenSearch service que vous souhaitez utiliser.

**Pour ajouter des données de OpenSearch service à une analyse**

1. Choisissez **Analyses** sur la gauche.

1. Effectuez l’une des actions suivantes :
   + Pour créer une nouvelle analyse, choisissez **Nouvelle analyse** en haut à droite. 
   + Pour compléter une analyse existante, ouvrez l’analyse que vous désirez modifier. 
     + Choisissez l’icône de crayon en haut à gauche.
     + Choisissez **Ajouter un jeu de données**.

1. Choisissez le jeu OpenSearch de données de service que vous souhaitez ajouter. 

   Pour plus d'informations sur l'utilisation OpenSearch de Service dans les visualisations, consultez[Limitations relatives à l'utilisation OpenSearch du service](#limitations-for-es). 

1. Pour plus d’informations, consultez [Utilisation des analyses](https://docs.aws.amazon.com/quicksight/latest/user/working-with-analyses.html).

## Limitations relatives à l'utilisation OpenSearch du service
<a name="limitations-for-es"></a>

Les limites suivantes s'appliquent à l'utilisation des ensembles OpenSearch de données de service :
+ OpenSearch Les ensembles de données de service prennent en charge un sous-ensemble de types visuels, d'options de tri et d'options de filtrage.
+ Pour activer l'actualisation automatique sur un tableau de bord publié qui utilise des données de OpenSearch service, le jeu de données de OpenSearch service doit utiliser une requête directe.
+ Les opérations de sous-requêtes multiples ne sont pas prises en charge. Pour éviter les erreurs lors de la visualisation, n’ajoutez pas plusieurs champs à un champ, utilisez un ou deux champs par visualisation et évitez de d’utiliser le sélecteur de champs **Couleur**.
+ Le SQL personnalisé n’est pas pris en charge.
+ Les jointures entre jeux de données et les jointures automatiques ne sont pas prises en charge.
+ Les champs calculés ne sont pas pris en charge. 
+ Les champs de texte ne sont pas pris en charge. 
+ La catégorie « autre » n’est pas prise en charge. Si vous utilisez un jeu de données de OpenSearch service avec une visualisation qui prend en charge la catégorie « autre », désactivez la catégorie « autre » en utilisant le menu du visuel. 

# Création d’un jeu de données à partir de fichiers Amazon S3
<a name="create-a-data-set-s3"></a>

Pour créer un ensemble de données à l'aide d'un ou de plusieurs fichiers texte (.csv, .tsv, .clf ou .elf) d'Amazon S3, créez un manifeste pour Quick Sight. Quick Sight utilise ce manifeste pour identifier les fichiers que vous souhaitez utiliser et pour définir les paramètres de téléchargement nécessaires à leur importation. Lorsque vous créez un jeu de données à l’aide d’Amazon S3, les données du fichier sont automatiquement importées dans [SPICE](spice.md).

Vous devez autoriser Quick Sight à accéder à tous les compartiments Amazon S3 à partir desquels vous souhaitez lire des fichiers. Pour plus d'informations sur l'octroi à Quick Sight de l'accès aux AWS ressources, consultez[Configuration de l'accès aux sources de AWS données par Amazon Quick Sight](access-to-aws-resources.md).

**Topics**
+ [Formats pris en charge pour les fichiers manifestes Amazon S3](supported-manifest-file-format.md)
+ [Création de jeux de données Amazon S3](create-a-data-set-s3-procedure.md)
+ [Ensembles de données utilisant des fichiers S3 dans un autre compte AWS](using-s3-files-in-another-aws-account.md)

# Formats pris en charge pour les fichiers manifestes Amazon S3
<a name="supported-manifest-file-format"></a>

Vous utilisez des fichiers manifestes JSON pour spécifier les fichiers dans Amazon S3 à importer dans Quick Sight. Ces fichiers manifestes JSON peuvent utiliser le format Quick Sight décrit ci-dessous ou le format Amazon Redshift décrit dans [Utilisation d'un manifeste pour spécifier des fichiers de données](https://docs.aws.amazon.com/redshift/latest/dg/loading-data-files-using-manifest.html) dans le manuel *Amazon Redshift Database Developer* Guide. Il n’est pas nécessaire de faire appel à Amazon Redshift pour utiliser le format de fichier manifeste Amazon Redshift. 

Si vous utilisez un fichier manifeste Quick Sight, il doit avoir une extension .json, par exemple`my_manifest.json`. Si vous utilisez un fichier manifeste Amazon Redshift il peut avoir n’importe quelle extension. 

Si vous utilisez un fichier manifeste Amazon Redshift, Quick Sight traite l'`mandatory`option facultative comme le fait Amazon Redshift. Si le fichier associé n'est pas trouvé, Quick Sight met fin au processus d'importation et renvoie un message d'erreur. 

Les fichiers que vous sélectionnez pour l’importation doivent être au format texte délimité (par exemple, .csv ou .tsv), au format de fichier journal (.clf) ou journal étendu (.elf), ou au format JSON (.json). Tous les fichiers identifiés dans un fichier manifeste doivent utiliser le même format de fichier. Ils doivent également avoir le même nombre et le même type de colonnes. Quick Sight prend en charge le codage de fichiers UTF-8, mais pas l'UTF-8 avec marque d'ordre d'octet (BOM). Si vous importez des fichiers JSON, pour `globalUploadSettings` vous devez spécifier `format`, mais pas `delimiter`, `textqualifier` ou `containsHeader`.

Assurez-vous que tous les fichiers que vous spécifiez se trouvent dans des compartiments Amazon S3 auxquels vous avez accordé l'accès à Quick Sight. Pour plus d'informations sur l'octroi à Quick Sight de l'accès aux AWS ressources, consultez[Configuration de l'accès aux sources de AWS données par Amazon Quick Sight](access-to-aws-resources.md).

## Format de fichier manifeste pour Quick Sight
<a name="quicksight-manifest-file-format"></a>

Les fichiers manifestes Quick Sight utilisent le format JSON suivant.

```
{
    "fileLocations": [
        {
            "URIs": [
                "uri1",
                "uri2",
                "uri3"
            ]
        },
        {
            "URIPrefixes": [
                "prefix1",
                "prefix2",
                "prefix3"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "JSON",
        "delimiter": ",",
        "textqualifier": "'",
        "containsHeader": "true"
    }
}
```

Utilisez les champs dans l’élément `fileLocations` pour spécifier les fichiers à importer et les champs dans l’élément `globalUploadSettings` pour spécifier les paramètres d’importation pour ces fichiers, tels que les délimiteurs de champs. 

Les éléments du fichier manifeste sont décrits ci-après.
+ **fileLocations** – Cet élément permet de spécifier les fichiers à importer. Pour ce faire, vous pouvez utiliser l’un ou l’autre des tableaux `URIs` et `URIPrefixes`, ou les deux. Vous devez spécifier au moins une valeur dans une ou l’autre de ces tableaux.
  + **URIs**— Utilisez ce tableau URIs pour répertorier les fichiers spécifiques à importer.

    Quick Sight peut accéder aux fichiers Amazon S3 qui se trouvent dans n'importe quel fichier Région AWS. Toutefois, vous devez utiliser un format d'URI qui identifie la AWS région du compartiment Amazon S3 s'il est différent de celui utilisé par votre compte Quick.

    URIs dans les formats suivants sont pris en charge.  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/quick/latest/userguide/supported-manifest-file-format.html)
  + **URIPrefixes**— Utilisez ce tableau pour répertorier les préfixes d'URI pour les compartiments et dossiers S3. Tous les fichiers d’un compartiment ou d’un dossier spécifié sont importés. Quick Sight récupère de manière récursive les fichiers des dossiers enfants.

    Quick Sight peut accéder aux compartiments ou dossiers Amazon S3 qui se trouvent dans n'importe quel Région AWS compartiment. Assurez-vous d'utiliser un format de préfixe d'URI qui identifie le compartiment S3 Région AWS s'il est différent de celui utilisé par votre compte Quick.

    Les préfixes d’URI aux formats suivants sont pris en charge :  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/quick/latest/userguide/supported-manifest-file-format.html)
+ **globalUploadSettings**— (Facultatif) Utilisez cet élément pour spécifier les paramètres d'importation pour les fichiers Amazon S3, tels que les délimiteurs de champs. Si cet élément n'est pas spécifié, Quick Sight utilise les valeurs par défaut pour les champs de cette section.
**Important**  
Pour les fichiers journaux (.clf) et les journaux étendus (.elf), seul le champ **format** dans cette section s’applique, vous pouvez donc ignorer les autres champs. Si vous décidez de les inclure, leurs valeurs sont ignorées. 
  + **format** – (Facultatif) Spécifiez le format des fichiers à importer. Les formats valides sont **CSV**, **TSV**, **CLF**, **ELF** et **JSON**. La valeur par défaut est **CSV**.
  + **délimiteur** – (Facultatif) Spécifiez le délimiteur de champs du fichier. Celui-ci doit correspondre au type de fichier spécifié dans le champ `format`. Les formats valides sont les virgules (**,**) pour les fichiers .csv et les tabulations (**\$1t**) pour les fichiers .tsv. La valeur par défaut est la virgule (**,**).
  + **textqualifier** – (facultatif) Spécifiez le qualificateur de texte de fichier. Les formats valables sont les guillemets simples (**'**), les guillemets doubles (**\$1"**). La barre oblique inverse de début est un caractère d’échappement obligatoire pour les guillemets dans JSON. La valeur par défaut est guillemets (**\$1"**). Si votre texte n’a pas besoin d’un qualificateur de texte, n’incluez pas cette propriété.
  + **containsHeader** – (facultatif) Spécifiez si le fichier possède une ligne d’en-tête. Les formats valides sont **true** ou **false**. La valeur par défaut est **true**.

### Exemples de fichiers manifestes pour Quick Sight
<a name="quicksight-manifest-file-examples"></a>

Voici quelques exemples de fichiers manifestes Quick Sight terminés.

L’exemple suivant montre un fichier manifeste qui identifie deux fichiers .csv spécifiques pour l’importation. Ces fichiers utilisent des guillemets comme qualificateurs de texte. Les champs `format`, `delimiter` et `containsHeader` sont ignorés, car les valeurs par défaut sont acceptables.

```
{
    "fileLocations": [
        {
            "URIs": [
                "https://yourBucket.s3.amazonaws.com/data-file.csv",
                "https://yourBucket.s3.amazonaws.com/data-file-2.csv"
            ]
        }
    ],
    "globalUploadSettings": {
        "textqualifier": "\""
    }
}
```

L’exemple suivant montre un fichier manifeste qui identifie un fichier .csv spécifique pour l’importation. Ce fichier inclut également un compartiment d’une autre région AWS contenant les fichiers .tsv supplémentaires à importer. Les champs `textqualifier` et `containsHeader` sont ignorés, car les valeurs par défaut sont acceptables.

```
{
    "fileLocations": [
        {
            "URIs": [
                "https://s3.amazonaws.com/amzn-s3-demo-bucket/data.tsv"
            ]
        },
        {
            "URIPrefixes": [
                "https://s3-us-east-1.amazonaws.com/amzn-s3-demo-bucket/"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "TSV",
        "delimiter": "\t"
    }
}
```

L’exemple suivant identifie deux compartiments qui contiennent des fichiers .clf pour l’importation. L'un est Région AWS identique au compte Quick et l'autre dans un compte différent Région AWS. Les champs `delimiter`, `textqualifier` et `containsHeader` sont ignorés, car ils ne concernent pas les fichiers journaux.

```
{
    "fileLocations": [
        {
            "URIPrefixes": [
                "https://amzn-s3-demo-bucket1.your-s3-url.com",
                "s3://amzn-s3-demo-bucket2/"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "CLF"
    }
}
```

L’exemple suivant utilise le format Amazon Redshift pour identifier un fichier .csv pour l’importation.

```
{
    "entries": [
        {
            "url": "https://amzn-s3-demo-bucket.your-s3-url.com/myalias-test/file-to-import.csv",
            "mandatory": true
        }
    ]
}
```

L’exemple suivant utilise le format Amazon Redshift pour identifier deux fichiers JSON pour l’importation.

```
{
    "fileLocations": [
        {
            "URIs": [
                "https://yourBucket.s3.amazonaws.com/data-file.json",
                "https://yourBucket.s3.amazonaws.com/data-file-2.json"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "JSON"
    }
}
```

# Création de jeux de données Amazon S3
<a name="create-a-data-set-s3-procedure"></a>

**Créer un jeu de données Amazon S3**

1. Vérifiez les [Quotas de source de données](data-source-limits.md) pour vous assurer que votre jeu de fichiers cibles ne dépasse par les quotas de source de données.

1. Créez un fichier manifeste pour identifier les fichiers texte à importer, dans l’un des formats spécifiés dans [Formats pris en charge pour les fichiers manifestes Amazon S3](supported-manifest-file-format.md).

1. Vous pouvez enregistrer le fichier manifeste dans un répertoire local ou le charger dans Amazon S3.

1. Sur la page de démarrage rapide, sélectionnez **Data**.

1. Sur la page **Données**, choisissez **Créer** puis **Nouvel ensemble de données**.

1. Choisissez l'icône Amazon S3, puis cliquez sur **Next**.

1. Dans **Data source name, (Nom de la source de données)**, saisissez une description de la source de données. Ce nom doit vous aider à distinguer cette source de données d’autres sources.

1. Pour **Upload a manifest file**, utilisez l’une des options suivantes :
   + Pour utiliser un fichier manifeste local, sélectionnez **Upload**, puis **Upload a JSON manifest file**. Pour **Open**, sélectionnez un fichier, puis choisissez **Open**.
   + Pour utiliser un fichier manifeste depuis Amazon S3, choisissez **URL** et entrez l’URL du fichier manifeste. Pour trouver l’URL d’un fichier manifeste préexistant dans la console Amazon S3, accédez au fichier approprié et choisissez-le. Un volet de propriétés s’affiche avec l’URL du lien. Vous pouvez copier l'URL et la coller dans Quick Sight.

1. Choisissez **Se connecter**.

1. Pour vous assurer que la connexion est terminée, sélectionnez **Edit/Preview data**. Sinon, sélectionnez **Visualize** pour créer une analyse en utilisant les données telles quelles. 

   Si vous choisissez **Modifier/apercevoir des données**, vous pouvez spécifier un nom de jeu de données dans le cadre de la préparation des données. Sinon, le nom du jeu de données correspondra à celui du fichier manifeste. 

   Pour en savoir plus sur la préparation des données, consultez [Préparation des données dans Amazon Quick Sight](preparing-data.md).

## Création de jeux de données basés sur plusieurs fichiers Amazon S3
<a name="data-sets-based-on-multiple-s3-files"></a>

Vous pouvez utiliser l'une des méthodes suivantes pour fusionner ou combiner des fichiers provenant de compartiments Amazon S3 dans Quick Sight :
+ **Combinez les fichiers en utilisant un manifeste** – Dans ce cas, les fichiers doivent avoir le même nombre de champs (colonnes). Les types de données doivent correspondre entre champs de même position dans le fichier. Par exemple, le premier champ doit avoir le même type de données dans chaque fichier. Il en va de même pour le second champ, le troisième et ainsi de suite. Quick Sight prend les noms de champs du premier fichier.

  Les fichiers doivent être explicitement énumérés dans le manifeste. Cependant, ils n’ont pas besoin d’être dans le même compartiment Amazon S3.

  De plus, les fichiers doivent suivre les règles décrites dans [Formats pris en charge pour les fichiers manifestes Amazon S3](supported-manifest-file-format.md).

  Pour plus de détails sur la combinaison des fichiers à l’aide d’un manifeste, voir [Création d’un jeu de données à partir de fichiers Amazon S3](create-a-data-set-s3.md).
+ **Fusionner des fichiers sans utiliser de manifeste** – Vous pouvez utiliser Athena pour fusionner plusieurs fichiers en un seul, sans devoir les répertorier individuellement dans le manifeste. Grâce à cette méthode, vous pouvez simplement interroger vos fichiers texte tels qu’ils le sont dans un tableau de base de données. Pour de plus amples informations, consultez le billet [Analyzing data in Amazon S3 using Athena](https://aws.amazon.com/blogs/big-data/analyzing-data-in-s3-using-amazon-athena/) dans le blog Big Data. 
+ **Utiliser un script pour ajouter des fichiers avant l’importation** – Vous pouvez utiliser un script conçu pour combiner vos fichiers avant de les télécharger. 

# Ensembles de données utilisant des fichiers S3 dans un autre compte AWS
<a name="using-s3-files-in-another-aws-account"></a>

Utilisez cette section pour savoir comment configurer la sécurité afin de pouvoir utiliser Quick Sight pour accéder aux fichiers Amazon S3 depuis un autre AWS compte. 

Pour que vous puissiez accéder à des fichiers dans un autre compte, le propriétaire de ce compte doit d’abord configurer Amazon S3 afin de vous octroyer des autorisations de lecture pour les fichiers. Ensuite, dans Quick Sight, vous devez configurer l'accès aux buckets qui ont été partagés avec vous. Une fois ces deux étapes terminées, vous pouvez utiliser un manifeste pour créer un jeu de données.

**Note**  
 Pour accéder à des fichiers partagés publiquement, il n’est pas nécessaire d’appliquer une configuration de sécurité spécifique. Cependant, vous avez tout de même besoin d’un fichier manifeste.

**Topics**
+ [Configuration d'Amazon S3 pour autoriser l'accès depuis un autre compte Quick](#setup-S3-to-allow-access-from-a-different-quicksight-account)
+ [Configuration de Quick Sight pour accéder aux fichiers Amazon S3 depuis un autre AWS compte](#setup-quicksight-to-access-S3-in-a-different-account)

## Configuration d'Amazon S3 pour autoriser l'accès depuis un autre compte Quick
<a name="setup-S3-to-allow-access-from-a-different-quicksight-account"></a>

Utilisez cette section pour savoir comment définir des autorisations dans les fichiers Amazon S3 afin que Quick Sight puisse y accéder depuis un autre AWS compte. 

Pour plus d'informations sur l'accès aux fichiers Amazon S3 d'un autre compte depuis votre compte Quick Sight, consultez[Configuration de Quick Sight pour accéder aux fichiers Amazon S3 depuis un autre AWS compte](#setup-quicksight-to-access-S3-in-a-different-account). Pour plus d’informations sur les autorisations S3, reportez-vous aux sections [Gestion des autorisations d’accès de vos ressources Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html) et [Comment définir des autorisations sur un objet ?](https://docs.aws.amazon.com/AmazonS3/latest/user-guide/set-object-permissions.html).

Vous pouvez utiliser la procédure suivante pour configurer cet accès via la console S3. Vous pouvez également accorder des autorisations en utilisant le AWS CLI ou en écrivant un script. Si vous devez partager un grand nombre de fichiers, créez plutôt une stratégie de compartiment S3 sur l’action `s3:GetObject`. Pour utiliser une stratégie de compartiment, ajoutez-la aux autorisations du compartiment et non à celles des fichiers. Pour de plus amples informations sur les stratégies de compartiment, veuillez consulter les [exemples de stratégies de compartiment](https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html) du *manuel du développeur Amazon S3*.

**Pour configurer l'accès depuis un autre compte Quick depuis la console S3**

1. Obtenez l'adresse e-mail de l'e-mail du AWS compte avec lequel vous souhaitez partager. Vous pouvez aussi obtenir et utiliser l’identifiant d’utilisateur canonique. Pour plus d'informations sur l'utilisateur canonique IDs, voir les [identifiants de AWS compte](https://docs.aws.amazon.com/general/latest/gr/acct-identifiers.html) dans le manuel de référence *AWS général*.

1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Trouvez le compartiment Amazon S3 que vous souhaitez partager avec Quick Sight. Choisissez **Autorisations**.

1. Choisissez **Ajouter un compte**, puis entrez une adresse e-mail ou collez un ID utilisateur canonique pour le AWS compte avec lequel vous souhaitez partager. Cette adresse e-mail doit être la principale pour le compte AWS . 

1. Choisissez **Oui** pour **Lecture des autorisations du compartiment** et pour **Répertorier les objets**.

   Choisissez **Enregistrer** pour confirmer.

1. Recherchez le fichier que vous souhaitez partager et ouvrez ses paramètres d’autorisation. 

1. Entrez une adresse e-mail ou le nom d'utilisateur canonique du AWS compte avec lequel vous souhaitez partager. Cette adresse e-mail doit être la principale du AWS compte. 

1. Activez les autorisations de **lecture des objets** pour chaque fichier auquel Quick Sight doit accéder. 

1. Informez l'utilisateur de Quick que les fichiers sont désormais disponibles.

## Configuration de Quick Sight pour accéder aux fichiers Amazon S3 depuis un autre AWS compte
<a name="setup-quicksight-to-access-S3-in-a-different-account"></a>

Utilisez cette section pour savoir comment configurer Quick Sight afin de pouvoir accéder aux fichiers Amazon S3 depuis un autre AWS compte. Pour savoir comment autoriser quelqu'un d'autre à accéder à vos fichiers Amazon S3 depuis son compte Quick, consultez[Configuration d'Amazon S3 pour autoriser l'accès depuis un autre compte Quick](#setup-S3-to-allow-access-from-a-different-quicksight-account).

Suivez la procédure ci-dessous pour accéder aux fichiers Amazon S3 d'un autre compte depuis Quick Sight. Au préalable, les utilisateurs de l’autre compte AWS doivent avoir partagé les fichiers de leur compartiment Amazon S3 avec vous.

**Pour accéder aux fichiers Amazon S3 d'un autre compte depuis Quick Sight**

1. Vérifiez que l'utilisateur ou les utilisateurs de l'autre AWS compte ont accordé à votre compte l'autorisation de lecture et d'écriture pour le compartiment S3 en question. 

1. Choisissez l'icône de votre profil, puis sélectionnez **Gérer Quick Sight**.

1. Choisissez **Security & permissions (Sécurité et autorisations)**.

1. Sous **Accès rapide aux AWS services**, sélectionnez **Gérer**.

1. Choisissez **Sélectionner les compartiments S3**.

1. Sur l’écran **Sélectionner des compartiments Amazon S3**, choisissez l’onglet **compartiments S3 auquel vous pouvez accéder sur AWS**.

   L'onglet par défaut est nommé **compartiments S3 liés au compte Quick Sight**. Il affiche tous les compartiments auxquels votre compte Quick a accès. 

1. Effectuez l’une des actions suivantes :
   + Si vous souhaitez ajouter tous les compartiments que vous avez l’autorisation d’utiliser, choisissez **Choisir les compartiments accessibles depuis les autres comptes AWS **. 
   + Si vous souhaitez ajouter un ou plusieurs compartiments Amazon S3, vous devez entrer leurs noms. Chaque compartiment doit correspondre exactement au nom unique du compartiment Amazon S3.

     Si vous n’avez pas les autorisations appropriées, le message d’erreur suivant s’affiche : « We can’t connect to this S3 bucket. Assurez-vous que tous les compartiments S3 que vous spécifiez sont associés au AWS compte utilisé pour créer ce compte Quick. » Ce message d'erreur s'affiche si vous ne disposez ni des autorisations de compte, ni des autorisations Quick Sight.
**Note**  
Pour utiliser Amazon Athena, Quick Sight doit accéder aux compartiments Amazon S3 utilisés par Athena.   
Vous pouvez les ajouter ici un par un ou utiliser l'option **Choisir les compartiments accessibles depuis d'autres AWS comptes**.

1. Choisissez **Select buckets** pour confirmer votre sélection. 

1. Créez un nouveau jeu de données basé sur Amazon S3 et chargez votre fichier manifeste. Pour de plus amples informations sur les jeux de données Amazon S3, consultez la rubrique [Création d’un jeu de données à partir de fichiers Amazon S3](create-a-data-set-s3.md).

# Création d’une source de données en utilisant Apache Spark
<a name="create-a-data-source-spark"></a>

Vous pouvez vous connecter directement à Apache Spark à l'aide de Quick Sight, ou vous pouvez vous connecter à Spark via Spark SQL. À l'aide des résultats de requêtes ou de liens directs vers des tables ou des vues, vous créez des sources de données dans Quick Sight. Vous pouvez soit interroger directement vos données via Spark, soit importer les résultats de votre requête dans [SPICE](spice.md).

Avant d'utiliser Quick Sight avec les produits Spark, vous devez configurer Spark pour Quick Sight. 

Quick Sight nécessite que votre serveur Spark soit sécurisé et authentifié à l'aide du protocole LDAP, disponible pour Spark version 2.0 ou ultérieure. Si Spark est configuré pour autoriser l'accès non authentifié, Quick Sight refuse la connexion au serveur. Pour utiliser Quick Sight en tant que client Spark, vous devez configurer l'authentification LDAP pour qu'elle fonctionne avec Spark. 

La documentation Spark indique comment effectuer cette configuration. Pour commencer, vous devez le configurer de façon à activer l’authentification LDAP frontale sur HTTPS. Pour obtenir des informations générales sur Spark, consultez le [site Web Apache Spark](http://spark.apache.org/). Pour obtenir des informations spécifiques sur Spark et la sécurité, consultez la section relative à la [sécurité dans la documentation Spark](http://spark.apache.org/docs/latest/security.html). 

Pour vous assurer que vous avez configuré votre serveur pour accéder à Quick Sight, suivez les instructions figurant dans[Exigences de configuration de réseau et de bases de données](configure-access.md).

# Utilisation de Databricks dans Quick Sight
<a name="quicksight-databricks"></a>

Utilisez cette section pour savoir comment vous connecter de Quick Sight à Databricks. 

**Se connecter à Databricks**

1. Commencez par créer un nouveau jeu de données. Choisissez **Data** dans le volet de navigation de gauche.

1. Choisissez **Créer** puis **Nouvel ensemble de données**.

1. Choisissez la carte de source de données **Databricks**.

1. Pour le **Nom de la source de données**, entrez un nom descriptif pour votre connexion à la source de données Databricks, par exemple `Databricks CS`. Comme vous pouvez créer de nombreux jeux de données à partir d’une connexion à Databricks, il est préférable de conserver un nom simple.

1. Pour **Type de connexion**, sélectionnez le type de réseau que vous utilisez. 
   + **Réseau public** : si vos données sont partagées publiquement.
   + **VPC** : si vos données se trouvent dans un VPC. 
**Note**  
Si vous utilisez un VPC et que celui-ci n’apparaît pas dans la liste, contactez votre administrateur. 

1.  Pour le **serveur de base de données**, saisissez le **nom d’hôte de l’espace de travail** spécifié dans les détails de votre connexion Databricks.

1.  Pour **Chemin HTTP**, saisissez l’**URL partielle de l’instance Spark** spécifiée dans les détails de votre connexion Databricks.

1.  Pour **Port**, saisissez le **port** spécifié dans les détails de votre connexion Databricks.

1.  Dans **Nom d’utilisateur** et **Mot de passe**, saisissez vos informations de connexion.

1.  Pour vérifier que la connexion fonctionne, cliquez sur **Valider la connexion**.

1.  Pour terminer et créer la source de données, cliquez sur **Créer une source de données**.

## Ajouter un nouveau jeu de données Quick Sight pour Databricks
<a name="quicksight-databricks-create-dataset"></a>

Après avoir établi une connexion à une source de données existante pour les données Databricks, vous pouvez créer des jeux de données Databricks à utiliser pour l’analyse. 

**Créer un jeu de données avec Databricks**

1. Choisissez **Data** sur la gauche, puis faites défiler l'écran vers le bas pour trouver la carte de source de données pour votre connexion Databricks. Si vous avez de nombreuses sources de données, vous pouvez utiliser la barre de recherche en haut de la page pour trouver un correspondance partielle avec votre source de données.

1. Choisissez la carte de source de données **Databricks**, puis choisissez **Créer un jeu de données**.

1. Pour spécifier le tableau auquel vous souhaitez vous connecter, sélectionnez d’abord le catalogue et le schéma que vous souhaitez utiliser. Ensuite, dans **Tableaux**, sélectionnez le tableau que vous souhaitez utiliser. Si vous préférez utiliser votre propre instruction SQL, sélectionnez **Utiliser un code SQL personnalisé**. 

1. Choisissez **Modifier/apercevoir**.

1. (En option) Pour ajouter d’autres données, procédez comme suit : 

   1. Choisissez **Ajouter des données** en haut à droite.

   1. Pour vous connecter à différentes données, choisissez **Changer de source de données**, puis choisissez un autre jeu de données. 

   1. Suivez les instructions de l’interface utilisateur et terminez l’ajout de données. 

   1. Après avoir ajouté de nouvelles données au même jeu de données, sélectionnez **Configurer cette jointure** (les deux points rouges). Configurez une jointure pour chaque tableau supplémentaire. 

   1. Pour ajouter des champs calculés, Sélectionnez **Ajouter un champ calculé**. 

   1. Pour ajouter un modèle issu de SageMaker l'IA, choisissez **Augmenter avec SageMaker.** Cette option n'est disponible que dans l'édition Quick Enterprise.

   1. Décochez tous les champs que vous souhaitez omettre.

   1. Mettez à jour les types de données que vous souhaitez modifier.

1. Lorsque vous avez terminé, sélectionnez **Enregistrer** pour enregistrer et fermer le jeu de données. 

## Guide de connexion à Databricks destiné à l'administrateur de Quick Sight
<a name="quicksight-databricks-administration-setup"></a>

Vous pouvez utiliser Amazon Quick Sight pour vous connecter à Databricks sur. AWS Vous pouvez vous connecter à Databricks, AWS que vous vous soyez inscrit via AWS Marketplace ou via le site Web de Databricks. 

Avant de pouvoir vous connecter à Databricks, vous devez créer ou identifier les ressources existantes requises par la connexion. Utilisez cette section pour vous aider à rassembler les ressources dont vous avez besoin pour vous connecter de Quick Sight à Databricks.
+ Pour savoir comment obtenir les détails de votre connexion Databricks, consultez [Connexions Databricks ODBCet JDBC](https://docs.databricks.com/integrations/jdbc-odbc-bi.html#get-server-hostname-port-http-path-and-jdbc-url). 
+ Pour savoir comment obtenir vos informations d’identification Databricks (jeton d’accès personnel ou nom d’utilisateur et mot de passe) à des fins d’authentification, consultez la section [Exigences d’authentification](https://docs.databricks.com/integrations/bi/jdbc-odbc-bi.html#authentication-requirements) dans la [documentation Databricks](https://docs.databricks.com/index.html). 

  Pour vous connecter à un cluster Databricks, vous avez besoin d’autorisations `Can Attach To` et `Can Restart`. Ces autorisations sont gérées dans Databricks. Pour plus d’informations, consultez la section [Exigences relatives aux autorisations](https://docs.databricks.com/integrations/jdbc-odbc-bi.html#permission-requirements) dans la [documentation Databricks.](https://docs.databricks.com/index.html)
+ Si vous configurez une connexion privée pour Databricks, vous pouvez en savoir plus sur la configuration d'un VPC pour une utilisation avec Quick Sight. Consultez la section Connexion [à un VPC avec Amazon Quick Sight dans la documentation de Quick](https://docs.aws.amazon.com/quicksight/latest/user/working-with-aws-vpc.html) Sight. Si la connexion n’est pas visible, vérifiez auprès d’un administrateur système que le réseau dispose de [points de terminaison entrants ouverts pour Amazon Route 53](https://docs.aws.amazon.com/quicksight/latest/user/vpc-route-53.html). Le nom d’hôte d’un espace de travail Databricks utilise une adresse IP publique, ainsi, des règles DNS TCP et DNS UDP entrantes et sortantes sont nécessaires pour autoriser le trafic sur le port DNS 53, à destination du groupe de sécurité Route 53. L’administrateur doit créer un groupe de sécurité avec deux règles entrantes : une pour le DNS (TCP) sur le port 53 du CIDR VPC, et une pour le DNS (UDP) pour le port 53 du CIDR VPC. 

  [Pour plus d'informations sur Databricks, si vous utilisez une connexion PrivateLink plutôt qu'une connexion publique, consultez la section [Activer AWS PrivateLink](https://docs.databricks.com/administration-guide/cloud-configurations/aws/privatelink.html) dans la documentation Databricks.](https://docs.databricks.com/index.html) 

# Création d’un jeu de données à l’aide de Google BigQuery
<a name="quicksight-google-big-query"></a>

**Note**  
Lorsque Quick Sight utilise et transfère des informations reçuesGoogle APIs, il adhère à la [politique relative aux données utilisateur des services Google API](https://developers.google.com/terms/api-services-user-data-policy).

Google BigQuery est un entrepôt de données sans serveur entièrement géré que les clients utilisent pour gérer et analyser leurs données. Les clients Google BigQuery utilisent SQL pour interroger leurs données sans aucune gestion d’infrastructure.

## Création d’une connexion à une source de données avec Google BigQuery
<a name="quicksight-google-big-query-connect"></a>

**Conditions préalables**

Avant de commencer, veillez à disposer des informations suivantes. Ils sont tous nécessaires pour créer une connexion à une source de données avec Google BigQuery :
+ **ID de projet** – ID de projet associé à votre Google compte. Pour le trouver, accédez à la Google Cloud console et choisissez le nom du projet que vous souhaitez connecter à Quick Sight. Copiez l’ID de projet qui apparaît dans la nouvelle fenêtre et enregistrez-le pour une utilisation ultérieure.
+ **Région du jeu de données** – La région Google dans laquelle le projet Google BigQuery existe. Pour trouver la région du jeu de données, accédez à la console Google BigQuery et choisissez **Explorer**. Recherchez et développez le projet que vous souhaitez connecter, puis choisissez le jeu de données que vous souhaitez utiliser. La région du jeu de données apparaît dans la fenêtre contextuelle qui s’ouvre.
+ **Google identifiants de connexion au compte** – Les identifiants de connexion à votre compte Google. Si vous ne disposez pas de ces informations, contactez l’administrateur du compte Google.
+ **Google BigQueryAutorisations** — Pour connecter votre Google compte à Quick Sight, assurez-vous que Google celui-ci dispose des autorisations suivantes :
  + `BigQuery Job User` au niveau `Project`.
  + `BigQuery Data Viewer` au niveau `Dataset` ou au niveau `Table`.
  + `BigQuery Metadata Viewer` au niveau `Project`.

Pour plus d'informations sur la façon de récupérer les informations prérequises précédentes, voir [Exploitez le potentiel de l'intelligence d'affaires unifiée avec Google Cloud BigQuery Quick Sight](https://aws.amazon.com/blogs/business-intelligence/unlock-the-power-of-unified-business-intelligence-with-google-cloud-bigquery-and-amazon-quicksight/).

Suivez la procédure ci-dessous pour connecter votre compte Quick à votre source de Google BigQuery données.

**Pour créer une nouvelle connexion à une source de Google BigQuery données à partir de Quick Sight**

1. Ouvrez la [console Quick](https://quicksight.aws.amazon.com/).

1. Dans le volet de navigation de gauche, sélectionnez **Data**.

1. Choisissez **Créer**, puis choisissez **Nouveau jeu de données**

1. Choisissez la vignette **Google BigQuery**.

1. Ajoutez les détails de la source de données que vous avez enregistrés dans la section des prérequis précédemment :
   + **Nom source de données** – Un nom pour la source de données.
   + **ID de projet — Identifiant** de projet Google Platform. Ce champ est sensible à la casse.
   + **Région du jeu de données** – La région du jeu de données de la plateforme Google cloud du projet que vous souhaitez connecter.

1. Choisissez **Sign in (Connexion)**.

1. Dans la nouvelle fenêtre qui s’ouvre, entrez les informations d’identification du Google compte auquel vous souhaitez vous connecter.

1. Choisissez **Continuer** pour autoriser Quick Sight à accéder àGoogle BigQuery.

1. Après avoir créé la nouvelle connexion à la source de données, passez à [Step 4](#gbq-step-4) dans la procédure suivante.

## Ajout d'un nouveau jeu de données Quick Sight pour Google BigQuery
<a name="quicksight-google-big-query-create"></a>

Après avoir créé une connexion à une source de données avec Google BigQuery, vous pouvez créer des jeux de données Google BigQuery à des fins d’analyse. Les jeux de données utilisant Google BigQuery ne peuvent être stockés que dans SPICE.

**Pour créer un jeu de données à l’aide de Google BigQuery**

1. Ouvrez la [console Quick](https://quicksight.aws.amazon.com/).

1. Sur la page d'accueil, sélectionnez **Data**.

1. Choisissez **Créer**, puis **Nouvel ensemble de données**

1. Choisissez la **Google BigQuery**vignette, puis sélectionnez **Créer un jeu de données**.

1. <a name="gbq-step-4"></a>Pour **Tables**, effectuez l’une des actions suivantes :
   + Choisissez la table que vous souhaitez utiliser.
   + Choisissez **Utiliser du code SQL personnalisé** pour utiliser votre propre instruction SQL personnelle. Pour plus d'informations sur l'utilisation de SQL personnalisé dans Quick Sight, consultez[Utilisation de SQL pour personnaliser les données](adding-a-SQL-query.md).

1. Choisissez **Modifier/apercevoir**.

1. (Facultatif) Dans la page de **préparation des données** qui s’ouvre, vous pouvez ajouter des personnalisations à vos données à l’aide de champs calculés, de filtres et de jointures.

1. Lorsque vous avez terminé avec les modifications, sélectionnez **Enregistrer** pour enregistrer et fermer le jeu de données.

# Création d’un jeu de données à l’aide d’une source de données Google Sheets
<a name="create-a-dataset-google-sheets"></a>

Google Sheets est une application de feuille de calcul Web qui permet aux utilisateurs de créer, de modifier et de collaborer sur des données en temps réel. Grâce à son ensemble complet de fonctions et de formules, il constitue une puissante source de données pour l’intelligence d’affaires et l’analytique. Les utilisateurs peuvent organiser, analyser et partager des informations de manière efficace, tandis que ses fonctionnalités de collaboration fluides en font une plateforme idéale pour les équipes travaillant sur des projets axés sur les données.

## Configuration de l'administration dans Amazon Quick
<a name="google-sheets-admin-config"></a>

Les administrateurs Amazon Quick doivent effectuer une configuration unique pour activer Google Sheets en tant que source de données. Pour des instructions détaillées et des considérations importantes, consultez [le blog](https://aws.amazon.com//blogs/business-intelligence/transform-your-google-sheets-data-into-powerful-analytics-with-amazon-quicksight/).

## Création d’un jeu de données à l’aide d’une source de données Google Sheets
<a name="google-sheets-create-dataset"></a>

Utilisez la procédure suivante pour créer un jeu de données à l’aide d’une source de données existante.

**Créer un jeu de données à l’aide d’une source de données Google Sheets**

1. Sur la page de démarrage rapide, sélectionnez **Ensembles de données.**

1. Sur la page **Jeux de données**, choisissez **Nouveau jeu de données**.

1. Choisissez **Google Sheets**.

1. Entrez un nom pour la source de données, puis choisissez **Connecter**.

1. Lorsque vous êtes redirigé vers la page de connexion de Google, procédez comme suit :

   1. Saisissez vos informations d’identification Google, puis choisissez **Suivant**.

   1. Vérifiez les autorisations permettant à votre AWS compte de se connecter à Google Sheets, puis choisissez **Continuer**.

1. Dans le menu **Choisissez votre tableau**, localisez vos données. Le menu affiche tous les dossiers, sous-dossiers, feuilles et onglets de votre compte Google. Pour afficher les onglets, sélectionnez une feuille dans la liste affichée.

1. Sélectionnez l’onglet avec lequel vous souhaitez travailler.

1. Choisissez **Modifier/Prévisualiser les données** pour accéder à la page de préparation des données. Choisissez **Ajouter des données** pour inclure des onglets supplémentaires.

1. Configurez la jointure, puis sélectionnez **Publier et visualiser** pour analyser vos données Google Sheets avec Quick Sight.

**Note**  
Ce connecteur prend uniquement en charge la fonctionnalité SPICE.
Si votre OAuth jeton expire (visible dans le rapport d'erreur d'ingestion ou lors de la création d'un nouvel ensemble de données), réautorisez-le en choisissant **Modifier** dans la source de données et en le mettant à jour.

# Création d’un jeu de données à partir d’une source de données Apache Impala
<a name="create-a-dataset-impala"></a>

Apache Impala est un moteur de requêtes SQL à traitement massivement parallèle (MPP) à hautes performances conçu pour fonctionner nativement sur Apache Hadoop. Suivez la procédure ci-dessous pour établir une connexion sécurisée entre Quick Sight et Apache Impala.

Tout le trafic entre Quick Sight et Apache Impala est crypté à l'aide du protocole SSL. Quick Sight prend en charge l'authentification standard par nom d'utilisateur et mot de passe pour les connexions Impala.

Pour établir une connexion, vous devez configurer les paramètres SSL dans votre instance Impala, préparer vos informations d'authentification, configurer la connexion dans Quick Sight à l'aide des informations de votre serveur Impala et valider la connexion pour garantir un accès sécurisé aux données.

**Créer un jeu de données à l’aide d’une source de données Apache Impala**

1. Sur la page de démarrage rapide, sélectionnez **Data**.

1. Sur la page **Données**, choisissez **Create**.

1. Choisissez **Source de données**.

1. Choisissez **Impala**, puis **Next**.

1. Entrez un nom pour la source de données.

1. Pour les connexions publiques :

   1. Entrez les détails de connexion pour le **serveur de base de données**, **le chemin HTTP, le** **port**, le **nom d’utilisateur** et le **mot de passe**.

   1. Une fois la validation réussie, choisissez **Create data source (Créer une source de données)**.

1. Pour les connexions privées :

   1. Coordonnez-vous avec votre administrateur pour configurer une connexion VPC avant de saisir les détails de connexion.

     Vous ou votre administrateur pouvez [configurer la connexion VPC dans](vpc-creating-a-connection-in-quicksight.md) Quick. SSL est activé par défaut pour garantir une transmission de données sécurisée. Si vous rencontrez des erreurs de validation de connexion, veuillez vérifier votre connexion et les détails du VPC.

     Si les problèmes persistent, consultez votre administrateur pour confirmer que votre autorité de certification figure dans la [liste des certificats approuvés](configure-access.md#ca-certificates) de Quick Sight.

1. Dans le menu **Choisissez votre table**, vous pouvez soit :

   1. Choisir un schéma ou une table spécifique, puis sélectionner **Sélectionner**.

   1. Pour écrire une requête SQL, choisissez **Utiliser un SQL personnalisé**.

1. Une fois votre sélection terminée, vous serez redirigé vers la page de préparation des données. Apportez les modifications nécessaires à vos données, puis choisissez **Publier et visualiser** pour analyser vos données Impala dans Quick Sight.

**Note**  
Ce connecteur prend en charge :  
Authentification par nom d’utilisateur et mot de passe
Connexions publiques et privées
Découverte de tables et requêtes SQL personnalisées
Actualisation complète des données pendant l’ingestion
Stockage SPICE uniquement

# Création d’un jeu de données à partir d’un fichier Microsoft Excel
<a name="create-a-data-set-excel"></a>

Pour créer un jeu de données à partir d’une source de données de fichier Microsoft Excel, chargez un fichier .xlsx à partir d’un lecteur local ou mis en réseau. Les données sont importées dans [SPICE](spice.md).

 Pour plus d’informations sur la création de nouveaux jeux de données Amazon S3 à l’aide de sources de données Amazon S3, voir [Création d’un jeu de données à partir d’une source de données Amazon S3 existante](create-a-data-set-existing.md#create-a-data-set-existing-s3) ou [Création d’un jeu de données à partir de fichiers Amazon S3](create-a-data-set-s3.md). 

**Créer un jeu de données basé sur un fichier Excel**

1. Vérifiez les [Quotas de source de données](data-source-limits.md) pour vous assurer que votre fichier cible ne dépasse par les quotas de source de données.

1. Sur la page de démarrage rapide, sélectionnez **Data**.

1. Sur la page **Données**, choisissez **Créer** puis **Nouvel ensemble de données**.

1. Choisissez **Upload a file**.

1. Dans la boîte de dialogue **Open**, sélectionnez un fichier, puis choisissez **Open**.

   Un fichier ne doit pas dépasser 1 Go pour être chargé dans Quick Sight.

1. Si le fichier Excel contient plusieurs feuilles, choisissez celle à importer. Vous pouvez par la suite revenir sur ce choix en préparant les données. 

1. 
**Note**  
Les écrans suivants vous offrent autant d’occasions de préparer les données. Chacun d’eux vous dirige vers l’écran **Prepare Data**. Cet écran est le même que celui auquel vous pouvez accéder après l’importation des données. Il vous permet de modifier les paramètres de chargement, même une fois celui-ci terminé.

    Choisissez **Select** pour confirmer vos paramètres. Vous pouvez également choisir **Edit/Preview data (Modifier/Prévisualiser les données)** pour préparer les données immédiatement.

   Un aperçu des données s’affiche sur l’écran suivant. Vous ne pouvez pas apporter de modifications directement dans l’aperçu des données. 

1. Si les en-têtes des données et le contenu ne s’affichent pas correctement, vous pouvez choisir **Modifier les paramètres et préparer des données** pour corriger les paramètres de chargement de fichier. 

   Sinon, choisissez **Next (Suivant)**.

1. Sur l’écran **Data Source Details**, vous pouvez choisir **Edit/Preview data**. Vous pouvez spécifier un nom de jeu de données sur l’écran **Préparer des données**. 

   Si vous n’avez pas besoin de préparer les données, vous pouvez choisir de créer une analyse en utilisant les données en l’état. Choisissez **Visualize**. Le jeu de données prend alors le nom du fichier source et vous êtes dirigé vers l’écran **Analyse**. Pour en savoir plus sur la préparation des données et les paramètres de chargement Excel, consultez [Préparation des données dans Amazon Quick Sight](preparing-data.md).

**Note**  
Si vous souhaitez apporter des modifications au fichier, par exemple en ajoutant un nouveau champ, vous devez effectuer les modifications dans Microsoft Excel et créer un nouveau jeu de données à l'aide de la version mise à jour dans Quick Sight. Pour plus d’informations sur les implications possibles de la modification des jeux de données, consultez la rubrique [Éléments à prendre en compte lors de la modification de jeux de données](edit-a-data-set.md#change-a-data-set).

# Création d’une source de données en utilisant Presto
<a name="create-a-data-source-presto"></a>

Presto (ou PrestoDB) est un moteur de requête SQL distribué open source conçu pour les requêtes d’analyse rapide sur des données de toutes tailles. Il prend en charge les sources de données non relationnelles et relationnelles. Les sources de données non relationnelles prises en charge incluent le système de fichiers distribué Hadoop (HDFS), Amazon S3, Cassandra, MongoDB et. HBase Les sources de données relationnelles prises en charge incluent MySQL, PostgreSQL, Amazon Redshift, Microsoft SQL Server et Teradata. 

Pour de plus amples informations sur Presto, veuillez consulter les ressources suivantes :
+ [Présentation de Presto](https://aws.amazon.com/big-data/what-is-presto/), description de Presto sur le AWS site Web.
+ [Création d'un cluster Presto avec Amazon Elastic MapReduce (EMR](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-presto.html)) dans le guide de mise à jour *d'Amazon EMR.*
+ Pour obtenir des informations générales sur Presto, veuillez consulter la [documentation Presto](https://trino.io/docs/current/).

Les résultats des requêtes que vous exécutez via le moteur de requêtes Presto peuvent être transformés en ensembles de données Quick Sight. Presto traite les requêtes analytiques sur les bases de données backend. Il renvoie ensuite les résultats au client Quick Sight. Vous pouvez interroger directement vos données via Presto ou importer les résultats de votre requête dans SPICE. 

Avant d'utiliser Quick Sight en tant que client Presto pour exécuter des requêtes, assurez-vous de configurer les profils de source de données. Vous avez besoin d'un profil de source de données dans Quick Sight pour chaque source de données Presto à laquelle vous souhaitez accéder. Utilisez la procédure suivante pour créer une connexion à Presto.

**Pour créer une nouvelle connexion à une source de données Presto depuis Amazon Quick Sight (console)**

1. Sur la page de démarrage d'Amazon Quick Sight, sélectionnez **Data** sur la gauche.

1. Choisissez **Créer** puis **Nouvel ensemble de données**. 

1. Choisissez la vignette **Presto** . 
**Note**  
Dans la plupart des navigateurs, vous pouvez utiliser Ctrl-F ou Cmd-F pour ouvrir une zone de recherche et entrer **presto** pour le localiser. 

1. Ajoutez les paramètres de la nouvelle source de données :
   + ****Nom de la source de données**** – Entrez un nom descriptif pour votre connexion à la source de données. Ce nom apparaît dans la section **Sources de données existantes** au bas de l’écran **Jeu de données** . 
   + ****Type de connexion**** – Choisissez le type de connexion que vous devez utiliser pour vous connecter à Presto. 

     Pour vous connecter via le réseau public, choisissez **Réseau public**. 

     Si vous utilisez un réseau public, votre serveur Presto doit être sécurisé et authentifié à l’aide du protocole LDAP (Lightweight Directory Access Protocol). Pour de plus amples informations sur la configuration de Presto pour utiliser LDAP, veuillez consulter [Authentification LDAP](https://trino.io/docs/current/security/ldap.html) dans la documentation Presto. 

     Pour vous connecter via une connexion privée virtuelle, choisissez le nom de VPC approprié dans la liste des **Connexions VPC** . 

     Si votre serveur Presto autorise un accès non authentifié, vous devez vous AWS y connecter de manière sécurisée à l'aide d'une connexion VPC privée. Pour de plus amples informations sur la configuration d’un nouveau VPC, veuillez consulter [Configuration des connexions VPC dans Amazon Quick Sight](working-with-aws-vpc.md).
   + ****Serveur de base de données**** – Nom du serveur de base de données. 
   + ****Port**** : port utilisé par le serveur pour accepter les connexions entrantes depuis Amazon Quick Sight 
   + ****Catalogue**** – Nom du catalogue que vous souhaitez utiliser. 
   + ****Authentification requise**** – (Facultatif) Cette option n’apparaît que si vous choisissez un type de connexion VPC. Si la source de données Presto à laquelle vous vous connectez ne nécessite pas d’authentification, sélectionnez **Non**. Sinon, laissez la valeur par défaut (**Oui**). 
   + ****Nom d’utilisateur**** – Entrez un nom d’utilisateur à utiliser pour la connexion à Presto. Quick Sight applique le même nom d'utilisateur et le même mot de passe à toutes les connexions utilisant ce profil de source de données. Si vous souhaitez surveiller Quick Sight séparément des autres comptes, créez un compte Presto pour chaque profil de source de données Quick Sight. 

     Le compte Presto que vous utilisez doit pouvoir accéder à la base de données et exécuter des instructions `SELECT` sur au moins une table. 
   + ****Mot de passe**** – Le mot de passe à utiliser avec le nom d’utilisateur Presto. Amazon Quick Sight chiffre toutes les informations d'identification que vous utilisez dans le profil de source de données. Pour de plus amples informations, veuillez consulter [Chiffrement des données dans Amazon Quick](data-encryption.md). 
   + ****Activer SSL**** – SSL est activé par défaut. 

1. Choisissez **Valider la connexion** pour tester vos paramètres.

1. Après avoir validé vos paramètres, choisissez **Créer une source de données** pour terminer la connexion.

# Utilisation de Snowflake avec Amazon Quick Sight
<a name="connecting-to-snowflake"></a>

Snowflake est une plateforme cloud de données basée sur l’IA qui fournit des solutions de données allant de l’entreposage de données et de la collaboration à la science des données et à l’IA générative. Snowflake est un [AWS partenaire](https://partners.amazonaws.com/partners/001E000000d8qQcIAI/Snowflake) titulaire de plusieurs AWS accréditations, notamment des compétences AWS ISV dans les domaines de l'IA générative, du Machine Learning, des données et de l'analyse, et du commerce de détail.

Amazon Quick Sight propose deux méthodes pour se connecter à Snowflake : avec vos identifiants de connexion Snowflake ou avec les identifiants client. OAuth Utilisez les sections suivantes pour en savoir plus sur ces deux méthodes de connexion.

**Topics**
+ [Création d'une connexion à une source de données Quick Sight à Snowflake avec des informations de connexion](#create-connection-to-snowflake)
+ [Création d'une connexion de source de données Quick Sight à Snowflake avec OAuth les informations d'identification du client](#create-connection-to-snowflake-oauth-credentials)

## Création d'une connexion à une source de données Quick Sight à Snowflake avec des informations de connexion
<a name="create-connection-to-snowflake"></a>

 Utilisez cette section pour savoir comment créer une connexion entre Quick Sight et Snowflake avec vos identifiants de connexion Snowflake. Tout le trafic entre Quick Sight et Snowflake est activé par SSL.

**Pour créer une connexion entre Quick Sight et Snowflake**

1. Ouvrez la [console Quick](https://quicksight.aws.amazon.com/).

1. Dans le volet de navigation de gauche, choisissez **Data**, puis **Create**, puis choisissez **New Dataset**.

1. Choisissez la carte de source de données **Snowflake**.

1. Dans la fenêtre contextuelle qui apparaît, entrez les informations suivantes :

   1. Pour le **Nom de la source de données**, entrez un nom descriptif pour votre connexion à la source de données Snowflake. Étant donné que vous pouvez créer de nombreux jeux de données à partir d’une connexion à Snowflake, il est préférable de choisir un nom simple.

   1. Pour **Type de connexion**, sélectionnez le type de réseau que vous utilisez. Si vos données sont partagées publiquement, choisissez **Réseau public**. Si vos données se trouvent dans un VPC, choisissez **VPC**. Pour configurer une connexion VPC dans Quick Sight, consultez. [Gestion de la connexion VPC dans Amazon Quick](vpc-creating-a-connection-in-quicksight.md)

   1. Pour le **serveur de base de données**, saisissez le nom d’hôte indiqué dans les détails de votre connexion Snowflake.

1. Pour le **nom de la base de données et l’entrepôt**, entrez la base de données Snowflake et le wearehouse respectifs auxquels vous souhaitez vous connecter.

1. Dans **Nom d’utilisateur** et **Mot de passe**, saisissez vos informations d’identification Snowflake.

Une fois que vous avez créé avec succès une connexion à une source de données entre vos comptes Quick Sight et Snowflake, vous pouvez commencer à [Création de jeux de données](creating-data-sets.md) contenir des données Snowflake.

## Création d'une connexion de source de données Quick Sight à Snowflake avec OAuth les informations d'identification du client
<a name="create-connection-to-snowflake-oauth-credentials"></a>

Vous pouvez utiliser les informations d'identification OAuth du client pour connecter votre compte Quick Sight à Snowflake via le [Quick](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_CreateDataSource.html) Sight. APIs *OAuth*est un protocole d'autorisation standard souvent utilisé pour les applications soumises à des exigences de sécurité avancées. Lorsque vous vous connectez à Snowflake avec les informations d'identification OAuth du client, vous pouvez créer des ensembles de données contenant des données Snowflake à l'aide du Quick Sight APIs et de l'interface utilisateur de Quick Sight. Pour plus d’informations sur la configuration OAuth dans Snowflake, consultez [Snowflake OAuth la présentation.](https://docs.snowflake.com/en/user-guide/oauth-snowflake-overview)

Quick Sight prend en charge le type de `client credentials` OAuth subvention. OAuthles informations d'identification du client sont utilisées pour obtenir un jeton d'accès pour machine-to-machine la communication. Cette méthode convient aux scénarios dans lesquels un client doit accéder à des ressources hébergées sur un serveur sans l’intervention d’un utilisateur.

Dans le flux d’informations d’identification client OAuth 2.0, plusieurs mécanismes d’authentification client peuvent être utilisés pour authentifier l’application cliente auprès du serveur d’autorisation. Quick Sight prend en charge les informations d'identification OAuth des clients basées sur Snowflake pour les deux mécanismes suivants :
+ **Jeton (basé sur les secrets du clientOAuth)** : le mécanisme d’authentification client basé sur le secret est utilisé avec les informations d’identification du client pour accorder le flux afin de s’authentifier auprès du serveur d’autorisation. Ce schéma d’authentification nécessite que le `client_id` et `client_secret` de l’application cliente OAuth soit stocké dans Secrets Manager.
+ **X509 (clé privée du client basée sur JWTOAuth)** : La solution basée sur une clé de certificat X509 fournit une couche de sécurité supplémentaire au mécanisme OAuth avec des certificats clients qui sont utilisés pour authentifier plutôt que des secrets clients. Cette méthode est principalement utilisée par les clients privés qui utilisent cette méthode pour s’authentifier auprès du serveur d’autorisation avec une forte confiance entre les deux services.

Quick Sight a validé OAuth les connexions avec les fournisseurs d'identité suivants :
+ OKTA
+ PingFederate

### Stockage d’informations d’identification OAuth dans Secrets Manager
<a name="create-connection-to-snowflake-oauth-store-credentials"></a>

OAuth les informations d'identification du client sont destinées à des cas d' machine-to-machineutilisation et ne sont pas conçues pour être interactives. Pour créer une connexion à une source de données entre Quick Sight et Snowflake, créez un nouveau secret dans Secrets Manager contenant vos informations d'identification pour l'OAuthapplication cliente. L'ARN secret créé avec le nouveau secret peut être utilisé pour créer des ensembles de données contenant des données Snowflake dans Quick Sight. Pour plus d'informations sur l'utilisation des touches du Gestionnaire de Secrets Manager dans Quick Sight, consultez[Utiliser des AWS Secrets Manager secrets au lieu des informations d'identification de base de données dans Quick](secrets-manager-integration.md).

Les informations d’identification que vous devez stocker dans Secrets Manager sont déterminées par le mécanisme OAuth que vous utilisez. Les key/value paires suivantes sont requises pour les secrets basés sur X509 OAuth :
+ `username`: le nom d’utilisateur du compte Snowflake à utiliser lors de la connexion à Snowflake
+ `client_id`: ID OAuth client
+ `client_private_key`: clé privée OAuth du client
+ `client_public_key`: la clé publique du certificat OAuth client et son algorithme chiffré (par exemple,`{"alg": "RS256", "kid", "cert_kid"}`)

Les key/value paires suivantes sont requises pour les secrets basés sur des jetons OAuth :
+ `username`: le nom d’utilisateur du compte Snowflake à utiliser lors de la connexion à Snowflake
+ `client_id`: ID OAuth client
+ `client_secret`: le client OAuth secret

### Création d'une OAuth connexion Snowflake avec le Quick Sight APIs
<a name="create-connection-to-snowflake-oauth-example"></a>

Une fois que vous avez créé un secret dans Secrets Manager contenant vos OAuth informations d'identification Snowflake et que vous avez connecté votre compte Quick à Secrets Manager, vous pouvez établir une connexion de source de données entre Quick Sight et Snowflake à l'aide du Quick Sight et du SDK. APIs L'exemple suivant crée une connexion à une source de données Snowflake à l'aide des informations d'identification OAuth du client jeton.

```
{
    "AwsAccountId": "AWSACCOUNTID",
    "DataSourceId": "UNIQUEDATASOURCEID",
    "Name": "NAME",
    "Type": "SNOWFLAKE",
    "DataSourceParameters": {
        "SnowflakeParameters": {
            "Host": "HOSTNAME",
            "Database": "DATABASENAME",
            "Warehouse": "WAREHOUSENAME",
            "AuthenticationType": "TOKEN",
            "DatabaseAccessControlRole": "snowflake-db-access-role-name",
            "OAuthParameters": {
              "TokenProviderUrl": "oauth-access-token-endpoint", 
              "OAuthScope": "oauth-scope",
              "IdentityProviderResourceUri" : "resource-uri",
              "IdentityProviderVpcConnectionProperties" : {
                "VpcConnectionArn": "IdP-VPC-connection-ARN" 
             }
        }
    },
    "VpcConnectionProperties": {
        "VpcConnectionArn": "VPC-connection-ARN-for-Snowflake"
    }
    "Credentials": {
        "SecretArn": "oauth-client-secret-ARN"
    }
}
```

Pour plus d'informations sur le fonctionnement de l' CreateDatasource API, consultez [CreateDataSource](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_CreateDataSource.html).

Une fois que la connexion entre Quick Sight et Snowflake est établie et qu'une source de données est créée avec le Quick Sight APIs ou le SDK, la nouvelle source de données est affichée dans Quick Sight. Les auteurs de Quick Sight peuvent utiliser cette source de données pour créer des ensembles de données contenant des données Snowflake. Les tableaux sont affichés en fonction du rôle utilisé dans le paramètre `DatabaseAccessControlRole` transmis lors d’un appel d’API `CreateDataSource`. Si ce paramètre n’est pas défini lors de la création de la connexion à la source de données, le rôle Snowflake par défaut est utilisé.

Une fois que vous avez créé avec succès une connexion à une source de données entre vos comptes Quick Sight et Snowflake, vous pouvez commencer à [Création de jeux de données](creating-data-sets.md) contenir des données Snowflake.

# Utilisation de Starburst avec Amazon Quick Sight
<a name="connecting-to-starburst"></a>

Starburst est un service complet d’analyse de lacs de données basé sur un moteur de requêtes MPP (Massively Parallel Processing), Trino. Utilisez cette section pour savoir comment vous connecter d'Amazon Quick Sight à Starburst. Tout le trafic entre Quick Sight et Starburst est activé par SSL. Si vous vous connectez à Starburst Galaxy, vous pouvez obtenir les informations de connexion nécessaires en vous connectant à votre compte Starburst Galaxy, puis en choisissant Partner **Connect** puis **Quick** Sight. Vous devriez pouvoir afficher des informations, telles que le nom d’hôte et le port. Amazon Quick Sight prend en charge l'authentification de base par nom d'utilisateur et mot de passe auprès de Starburst.

Quick Sight propose deux manières de se connecter à Starburst : avec vos identifiants de connexion Starburst ou avec les identifiants OAuth client. Utilisez les sections suivantes pour en savoir plus sur ces deux méthodes de connexion.

**Topics**
+ [Création d'une connexion de source de données Quick Sight à Starburst avec des informations de connexion](#create-connection-to-starburst)
+ [Création d'une connexion de source de données Quick Sight à Starburst avec les informations d'identification OAuth du client](#create-connection-to-starburst-oauth)

## Création d'une connexion de source de données Quick Sight à Starburst avec des informations de connexion
<a name="create-connection-to-starburst"></a>

1. Commencez par créer un nouveau jeu de données. Dans le volet de navigation de gauche, choisissez **Data**, puis **Create**, puis choisissez **New Dataset**.

1. Choisissez la carte source de données **Starburst**.

1. Sélectionnez le type de produit Starburst. Choisissez **Starburst Enterprise** pour les instances Starburst sur site. Choisissez **Starburst Galaxy** pour les instances gérées.

1. Pour le **Nom de la source de données**, entrez un nom descriptif pour votre connexion à la source de données Starburst. Comme vous pouvez créer de nombreux jeux de données à partir d’une connexion à Starburst, il est préférable de choisir un nom simple.

1. Pour **Type de connexion**, sélectionnez le type de réseau que vous utilisez. Si vos données sont partagées publiquement, choisissez **Réseau public**. Si vos données se trouvent dans un VPC, choisissez **VPC**. Pour configurer une connexion VPC dans Amazon Quick Sight, consultez [Configuration de la connexion VPC dans Amazon](https://docs.aws.amazon.com/quicksight/latest/user/vpc-creating-a-connection-in-quicksight.html) Quick Sight. Ce type de connexion n’est pas disponible pour Starburst Galaxy.

1. Pour le **serveur de base de données**, saisissez le nom d’hôte indiqué dans les détails de votre connexion Starburst.

1. Pour **Catalogue**, entrez le catalogue spécifié dans les détails de votre connexion Starburst.

1. Pour **Port**, entrez le port indiqué dans les détails de votre connexion Starburst. La valeur par défaut est 443 pour Starburst Galaxy.

1. Pour le **nom d’utilisateur** et le **mot de passe**, saisissez vos informations de connexion Starburst.

1. Pour vérifier que la connexion fonctionne, sélectionnez **Valider la connexion**.

1. Pour terminer et créer la source de données, sélectionnez **Créer une source de données**.

**Note**  
La connectivité entre Amazon Quick Sight et Starburst a été validée à l'aide de la version 420 de Starburst.

Après avoir créé avec succès une connexion à une source de données entre vos comptes Quick Sight et Starburst, vous pouvez commencer à contenir [Création de jeux de données](creating-data-sets.md) des données Starburst.

## Création d'une connexion de source de données Quick Sight à Starburst avec les informations d'identification OAuth du client
<a name="create-connection-to-starburst-oauth"></a>

Vous pouvez utiliser les informations d'identification OAuth du client pour connecter votre compte Quick Sight à Starburst via [Quick Sight APIs](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_CreateDataSource.html). *OAuth*est un protocole d'autorisation standard souvent utilisé pour les applications soumises à des exigences de sécurité avancées. Lorsque vous vous connectez à Starburst avec les informations d'identification OAuth du client, vous pouvez créer des ensembles de données contenant des données Starburst à l'aide du Quick Sight APIs et de l'interface utilisateur de Quick Sight. Pour plus d’informations sur la configuration OAuth dans Starburst, voir [Authentification OAuth 2.0](https://docs.starburst.io/latest/security/oauth2.html).

Quick Sight prend en charge le type de `client credentials` OAuth subvention. OAuthles informations d'identification du client sont utilisées pour obtenir un jeton d'accès pour machine-to-machine la communication. Cette méthode convient aux scénarios dans lesquels un client doit accéder à des ressources hébergées sur un serveur sans l’intervention d’un utilisateur.

Dans le flux d’informations d’identification client OAuth 2.0, plusieurs mécanismes d’authentification client peuvent être utilisés pour authentifier l’application cliente auprès du serveur d’autorisation. Quick Sight prend en charge les informations d'identification OAuth des clients basées sur Starburst pour les deux mécanismes suivants :
+ **Jeton (basé sur les secrets du clientOAuth)** : le mécanisme d’authentification client basé sur le secret est utilisé avec les informations d’identification du client pour accorder le flux afin de s’authentifier auprès du serveur d’autorisation. Ce schéma d’authentification nécessite que le `client_id` et `client_secret` de l’application cliente OAuth soit stocké dans Secrets Manager.
+ **X509 (clé privée du client basée sur JWTOAuth)** : La solution basée sur une clé de certificat X509 fournit une couche de sécurité supplémentaire au mécanisme OAuth avec des certificats clients qui sont utilisés pour authentifier plutôt que des secrets clients. Cette méthode est principalement utilisée par les clients privés qui utilisent cette méthode pour s’authentifier auprès du serveur d’autorisation avec une forte confiance entre les deux services.

Quick Sight a validé OAuth les connexions avec les fournisseurs d'identité suivants :
+ OKTA
+ PingFederate

### Stockage d’informations d’identification OAuth dans Secrets Manager
<a name="create-connection-to-starburst-oauth-store-credentials"></a>

OAuthles informations d'identification du client sont destinées à des cas d' machine-to-machineutilisation et ne sont pas conçues pour être interactives. Pour créer une connexion à une source de données entre Quick Sight et Starburst, créez un nouveau secret dans Secrets Manager contenant vos informations d'identification pour l'application OAuth cliente. L'ARN secret créé avec le nouveau secret peut être utilisé pour créer des ensembles de données contenant des données Starburst dans Quick Sight. Pour plus d'informations sur l'utilisation des touches du Gestionnaire de Secrets Manager dans Quick Sight, consultez[Utiliser des AWS Secrets Manager secrets au lieu des informations d'identification de base de données dans Quick](secrets-manager-integration.md).

Les informations d’identification que vous devez stocker dans Secrets Manager sont déterminées par le mécanisme OAuth que vous utilisez. Les key/value paires suivantes sont requises pour les secrets basés sur X509 OAuth :
+ `username`: le nom d’utilisateur du compte Starburst à utiliser lors de la connexion à Starburst
+ `client_id`: ID OAuth client
+ `client_private_key`: clé privée OAuth du client
+ `client_public_key`: la clé publique du certificat OAuth client et son algorithme chiffré (par exemple,`{"alg": "RS256", "kid", "cert_kid"}`)

Les key/value paires suivantes sont requises pour les secrets basés sur des jetons OAuth :
+ `username`: le nom d’utilisateur du compte Starburst à utiliser lors de la connexion à Starburst
+ `client_id`: ID OAuth client
+ `client_secret`: le client OAuth secret

### Création d'une OAuth connexion Starburst avec le Quick Sight APIs
<a name="create-connection-to-starburst-oauth-example"></a>

Après avoir créé un secret contenant vos OAuth identifiants Starburst dans Secrets Manager et avoir connecté votre compte Quick à Secrets Manager, vous pouvez établir une connexion de source de données entre Quick Sight et Starburst à l'aide du Quick Sight APIs et du SDK. L’exemple suivant crée une connexion à une source de données Starburst à l’aide des informations d’identification OAuth du client jeton.

```
{
    "AwsAccountId": "AWSACCOUNTID",
    "DataSourceId": "DATASOURCEID",
    "Name": "NAME",
    "Type": "STARBURST",
    "DataSourceParameters": {
        "StarburstParameters": {
            "Host": "STARBURST_HOST_NAME",
            "Port": "STARBURST_PORT",
            "Catalog": "STARBURST_CATALOG",
            "ProductType": "STARBURST_PRODUCT_TYPE",     
            "AuthenticationType": "TOKEN",
            "DatabaseAccessControlRole": "starburst-db-access-role-name",
            "OAuthParameters": {
              "TokenProviderUrl": "oauth-access-token-endpoint", 
              "OAuthScope": "oauth-scope",
              "IdentityProviderResourceUri" : "resource-uri",
              "IdentityProviderVpcConnectionProperties" : {
                "VpcConnectionArn": "IdP-VPC-connection-ARN"
            }
        }
    },
    "VpcConnectionProperties": {
        "VpcConnectionArn": "VPC-connection-ARN-for-Starburst"
    },
    "Credentials": {
        "SecretArn": "oauth-client-secret-ARN"
    }
}
```

Pour plus d'informations sur le fonctionnement de l' CreateDatasource API, consultez [CreateDataSource](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_CreateDataSource.html).

Une fois que la connexion entre Quick Sight et Starburst est établie et qu'une source de données est créée avec le Quick Sight APIs ou le SDK, la nouvelle source de données est affichée dans Quick Sight. Les auteurs de Quick Sight peuvent utiliser cette source de données pour créer des ensembles de données contenant des données Starburst. Les tableaux sont affichés en fonction du rôle utilisé dans le paramètre `DatabaseAccessControlRole` transmis lors d’un appel d’API `CreateDataSource`. Si ce paramètre n’est pas défini lors de la création de la connexion à la source de données, le rôle Starburst par défaut est utilisé.

Après avoir créé avec succès une connexion à une source de données entre vos comptes Quick Sight et Starburst, vous pouvez commencer à contenir [Création de jeux de données](creating-data-sets.md) des données Starburst.

# Création d’une source de données et d’un jeu de données à partir de sources SaaS
<a name="connecting-to-saas-data-sources"></a>

Pour analyser et générer des rapports sur les données provenant d'applications SaaS (Software as a Service), vous pouvez utiliser des connecteurs SaaS pour accéder à vos données directement depuis Quick Sight. Les connecteurs SaaS simplifient l’accès aux sources d’applications tierces à l’aide d’OAuth, sans avoir à exporter les données vers un magasin de données intermédiaire.

Vous pouvez utiliser une instance basée sur le cloud ou sur serveur d’une application SaaS. Pour vous connecter à une application SaaS exécutée sur le réseau de votre entreprise, assurez-vous que Quick Sight peut accéder au nom du système de noms de domaine (DNS) de l'application via le réseau. Si Quick Sight ne parvient pas à accéder à l'application SaaS, cela génère une erreur d'hôte inconnue. 

Voici des exemples d’utilisation de données SaaS :
+ Les équipes d’ingénierie qui utilisent Jira pour effectuer le suivi des problèmes et des bogues peuvent rendre compte de l’efficacité des développeurs et de la résolution des bogues. 
+ Les organisations de marketing peuvent intégrer Quick Sight à Adobe Analytics pour créer des tableaux de bord consolidés afin de visualiser leurs données marketing en ligne et sur le Web.

Utilisez la procédure suivante pour créer une source de données et un jeu de données en vous connectant aux sources disponibles via logiciel en tant que service (SaaS). Dans cette procédure, nous utilisons une connexion à GitHub comme exemple. D’autres sources de données SaaS suivent le même processus, mais les écrans, en particulier les écrans SaaS, peuvent se présenter différemment.

**Créer une source de données et un jeu de données en se connectant à des sources via SaaS**

1. Sur la page de démarrage rapide, sélectionnez **Data**.

1. Sur la page **Données**, choisissez **Créer**, puis **Nouveau jeu de données**.

1. Choisissez l'icône qui représente la source SaaS que vous souhaitez utiliser. Par exemple, vous pouvez choisir Adobe Analytics ou GitHub.

   Pour les sources qui utilisent OAuth, le connecteur vous dirige vers le site SaaS afin d’autoriser la connexion avant de vous permettre de créer la source de données. 

1. Choisissez un nom pour la source de données, puis saisissez-le. Si d’autres invites s’affichent, saisissez les informations demandées. Choisissez ensuite **Create data source** (Créer une source de données).

1. Si vous êtes invité à le faire, saisissez vos informations d’identification sur la page de connexion SaaS.

1. Lorsque vous y êtes invité, autorisez la connexion entre votre source de données SaaS et Quick Sight.

   L'exemple suivant montre l'autorisation permettant à Quick Sight d'accéder au GitHub compte pour la documentation de Quick Sight.
**Note**  
La documentation de Quick Sight est désormais disponible sur GitHub. Si vous souhaitez apporter des modifications à ce guide de l'utilisateur, vous pouvez l'utiliser GitHub pour le modifier directement.

   (Facultatif) Si votre compte SaaS fait partie d'un compte d'organisation, il peut vous être demandé de demander l'accès à l'organisation dans le cadre de l'autorisation de Quick Sight. Pour ce faire, suivez les instructions affichées sur votre écran SaaS, puis choisissez d'autoriser Quick Sight.

1. Une fois l’autorisation terminée, choisissez une table ou un objet auquel vous connecter. Puis choisissez **Sélectionner**.

1. Sur l’écran **Terminer la création du jeu de données**, choisissez l’une des options suivantes :
   + Pour enregistrer la source de données et le jeu de données, choisissez **Modifier/apercevoir des données**. Choisissez ensuite **Save** (Enregistrer) dans la barre de menus supérieure.
   + Pour créer un jeu de données et une analyse en utilisant les données telles quelles, choisissez **Visualize**. Cette option enregistre automatiquement la source de données et le jeu de données.

     Vous pouvez également choisir **Edit/Preview data** (Modifier/Prévisualiser les données) pour préparer les données avant de créer une analyse. Vous ouvrez ainsi l’écran de préparation de données. Pour plus d’informations sur la préparation des données, consultez [Exemples de jeux de données préparés](preparing-data-sets.md).

Les contraintes suivantes s’appliquent :
+ La source SaaS doit prendre en charge les opérations de l'API REST pour que Quick Sight puisse s'y connecter.
+ Si vous vous connectez à Jira, l’URL doit être une adresse publique.
+ Si vous n’avez pas suffisamment de capacité [SPICE](spice.md), choisissez **Edit/Preview data**. Sur l’écran de préparation des données, vous pouvez supprimer des champs du jeu de données pour réduire sa taille ou appliquer un filtre, ce qui réduit le nombre de lignes ou de colonnes renvoyées. Pour plus d’informations sur la préparation des données, consultez [Exemples de jeux de données préparés](preparing-data-sets.md).

# Création d’un jeu de données à partir de Salesforce
<a name="create-a-data-set-salesforce"></a>

Utilisez la procédure suivante pour créer un jeu de données grâce à une connexion à Salesforce et en sélectionnant un rapport ou un objet pour fournir des données.

**Créer un jeu de données à l’aide de Salesforce à partir d’un rapport ou d’un objet**

1. Vérifiez les [Quotas de source de données](data-source-limits.md) pour vous assurer que votre rapport ou objet cible ne dépasse pas les quotas de source de données.

1. Sur la page de démarrage rapide, sélectionnez **Data**.

1. Sur la page **Données**, choisissez **Créer** puis **Nouvel ensemble de données**.

1. Choisissez l'icône **Salesforce**.

1. Tapez un nom pour la source de données, puis choisissez **Create data source (Créer la source de données)**.

1. Sur la page de connexion Salesforce, entrez vos informations d’identification Salesforce.

1. Pour **Data elements: contain your data**, choisissez **Select**, puis choisissez **REPORT** ou **OBJECT**.
**Note**  
Les rapports joints ne sont pas pris en charge en tant que sources de données Quick Sight.

1. Choisissez l’une des options suivantes :
   + Pour préparer les données avant de créer une analyse, choisissez **Edit/Preview data** pour ouvrir la préparation des données. Pour plus d’informations sur la préparation des données, consultez [Exemples de jeux de données préparés](preparing-data-sets.md).
   + Dans le cas contraire, sélectionnez un rapport ou un objet, puis choisissez **Select**.

1. Choisissez l’une des options suivantes :
   + Pour créer un jeu de données et une analyse en utilisant les données telles quelles, choisissez **Visualize**.
**Note**  
Si vous n’avez pas suffisamment de capacité [SPICE](spice.md), choisissez **Edit/Preview data**. Lors de la préparation des données, vous pouvez supprimer des champs du jeu de données pour réduire sa taille ou appliquer un filtre, ce qui réduit le nombre de lignes ou de colonnes renvoyées. Pour plus d’informations sur la préparation des données, consultez [Exemples de jeux de données préparés](preparing-data-sets.md).
   + Pour préparer les données avant de créer une analyse, choisissez **Edit/Preview data** pour ouvrir la préparation des données pour le rapport ou l’objet sélectionné. Pour plus d’informations sur la préparation des données, consultez [Exemples de jeux de données préparés](preparing-data-sets.md).

**Note**  
Le connecteur Salesforce n'est pas pris en charge dans les déploiements de consoles intégrées dans lesquels les utilisateurs s'authentifient via l'isolation de l'espace de noms. Le flux OAuth d'authentification nécessite un accès direct à la console Amazon Quick Sight pour terminer le processus de connexion.

# Utilisation de Trino avec Amazon Quick Sight
<a name="connecting-to-trino"></a>

Trino est un moteur de requêtes MPP (Massively Parallel Processing) qui permet d’interroger rapidement des lacs de données contenant des pétaoctets de données. Utilisez cette section pour savoir comment vous connecter à Trino depuis Amazon Quick Sight. Tout le trafic entre Amazon Quick Sight et Trino est activé par SSL. Amazon Quick Sight prend en charge l'authentification de base par nom d'utilisateur et mot de passe auprès de Trino.

## Création d’une connexion à une source de données pour Trino
<a name="create-connection-to-trino"></a>

1. Commencez par créer un nouveau jeu de données. Dans le volet de navigation de gauche, sélectionnez **Data**. Choisissez **Créer**, puis **Nouvel ensemble de données**.

1. Choisissez la carte de source de données **Trino**.

1. Pour le **Nom de la source de données**, entrez un nom descriptif pour votre connexion à la source de données Trino. Comme vous pouvez créer de nombreux jeux de données à partir d’une connexion à Trino, il est préférable de choisir un nom simple.

1. Pour **Type de connexion**, sélectionnez le type de réseau que vous utilisez. Si vos données sont partagées publiquement, choisissez **Réseau public**. Si vos données se trouvent dans un VPC, choisissez **VPC**. Pour configurer une connexion VPC dans Amazon Quick Sight, consultez [Configuration de la connexion VPC dans Amazon](https://docs.aws.amazon.com/quicksight/latest/user/vpc-creating-a-connection-in-quicksight.html) Quick Sight.

1. Pour le **serveur de base de données**, saisissez le nom d’hôte indiqué dans les détails de votre connexion Trino.

1. Pour **Catalogue**, entrez le catalogue spécifié dans les détails de votre connexion Trino.

1. Pour **Port**, entrez le port indiqué dans les détails de votre connexion Trino.

1. Dans **Nom d’utilisateur** et **Mot de passe**, saisissez vos informations de connexion Trino.

1. Pour vérifier que la connexion fonctionne, sélectionnez **Valider la connexion**.

1. Pour terminer et créer la source de données, sélectionnez **Créer une source de données**.

## Ajout d'un nouveau jeu de données Amazon Quick Sight pour Trino
<a name="create-dataset-using-trino"></a>

Après avoir terminé le [processus de création de la source de données](https://docs.aws.amazon.com/create-connection-to-starburst.html) pour Trino, vous pouvez créer des jeux de données Trino à utiliser pour l’analyse. Vous pouvez créer de nouveaux jeux de données à partir d’une source de données Trino nouvelle ou existante. Lorsque vous créez une nouvelle source de données, Amazon Quick Sight vous amène immédiatement à créer un ensemble de données, comme indiqué à l'étape 3 ci-dessous. Si vous utilisez une source de données existante pour créer un nouveau jeu de données, commencez par l’étape 1 ci-dessous.

Pour créer un jeu de données à l’aide d’une source de données Trino, suivez les étapes ci-dessous.

1. Sur la page d'accueil, sélectionnez **Data**. Choisissez **Créer**, puis **Nouvel ensemble de données**.

1. Choisissez la source de données Trino que vous avez créée.

1. Choisissez **Create data set**.

1. Pour spécifier le tableau auquel vous connecter, sélectionnez un schéma. Si vous ne souhaitez pas choisir de schéma, vous pouvez aussi utiliser votre propre instruction SQL.

1. Pour spécifier le tableau auquel vous souhaitez vous connecter, sélectionnez d’abord le **schéma** que vous désirez utiliser. Pour **Tableaux**, sélectionnez le tableau que vous souhaitez utiliser. Si vous préférez utiliser votre propre instruction SQL, sélectionnez **Utiliser un code SQL personnalisé**.

1. Choisissez **Modifier/apercevoir**.

1. (En option) Pour ajouter d’autres données, procédez comme suit :

1. Choisissez **Ajouter des données** en haut à droite.

1. Pour vous connecter à différentes données, choisissez **Changer de source de données**, puis choisissez un autre jeu de données.

1. Suivez les instructions pour finaliser l’ajout de données.

1. Après avoir ajouté de nouvelles données au même jeu de données, sélectionnez **Configurer cette jointure** (les deux points rouges). Configurez une jointure pour chaque tableau supplémentaire.

1. Pour ajouter des champs calculés, Sélectionnez **Ajouter un champ calculé**.

1. Décochez tous les champs que vous souhaitez omettre.

1. Mettez à jour les types de données que vous souhaitez modifier.

1. Lorsque vous avez terminé, sélectionnez **Enregistrer** pour enregistrer et fermer le jeu de données.

**Note**  
La connectivité entre Quick Sight et Trino a été validée à l'aide de la version 410 de Trino.

# Création d’un jeu de données à partir d’un fichier texte local
<a name="create-a-data-set-file"></a>

Pour créer un jeu de données à l’aide d’une source de données d’un fichier texte local, identifiez l’emplacement du fichier, puis chargez-le. Les données du fichier sont automatiquement importées dans [SPICE](spice.md) dans le cadre de la création d’un jeu de données. 

**Créer un jeu de données basé sur un fichier de texte local**

1. Vérifiez les [Quotas de source de données](data-source-limits.md) pour vous assurer que votre fichier cible ne dépasse par les quotas de source de données.

   Les types de fichiers pris en charge sont notamment les fichiers .csv, .tsv, .json, .clf ou .elf.

1. Sur la page de démarrage rapide, sélectionnez **Data**.

1. Choisissez **Créer**, puis **Nouvel ensemble de données**.

1. Choisissez **Upload a file**.

1. Dans la boîte de dialogue **Open**, localisez un fichier, sélectionnez-le, puis choisissez **Open**.

   Un fichier ne doit pas dépasser 1 Go pour être chargé dans Quick Sight.

1. Pour préparer les données avant de créer le jeu de données, choisissez **Modifier/apercevoir des données**. Sinon, sélectionnez **Visualize** pour créer une analyse en utilisant les données telles quelles. 

   Si vous choisissez la première option, vous pouvez spécifier un nom de jeu de données dans le cadre de la préparation des données. Si vous choisissez la dernière option, un jeu de données portant le même nom que le fichier source est créé. Pour en savoir plus sur la préparation des données, consultez [Préparation des données dans Amazon Quick Sight](preparing-data.md).

# Utilisation des données Amazon Timestream avec Amazon Quick Sight
<a name="using-data-from-timestream"></a>

Vous trouverez ci-dessous comment vous connecter à vos données Amazon Timestream à l'aide d'Amazon Quick Sight. Pour un bref aperçu, consultez le [didacticiel vidéo Getting Started with Amazon Timestream QuickSight](https://youtu.be/TzW4HWl-L8s) sur. YouTube 

## Création d'une nouvelle connexion à une source de données Amazon Quick Sight pour une base de données Timestream
<a name="create-connection-to-timestream"></a>

Vous trouverez ci-dessous comment vous connecter à Amazon Timestream depuis Amazon Quick Sight.

Avant de continuer, Amazon Quick Sight doit être autorisé à se connecter à Amazon Timestream. Si les connexions ne sont pas activées, un message d’erreur s’affichera lorsque vous essaierez de vous connecter. Un administrateur de Quick Sight peut autoriser les connexions aux AWS ressources. Pour autoriser la connexion, ouvrez le menu en cliquant sur l’icône de votre profil en haut à droite. Choisissez **Gérer QuickSight**, **Sécurité et autorisations**, **Ajouter ou supprimer**. Cochez ensuite la case Amazon Timestream, puis sélectionnez **Mettre à jour** pour confirmer. Pour de plus amples informations, veuillez consulter [Configuration de l'accès aux sources de AWS données par Amazon Quick Sight](access-to-aws-resources.md).

**Se connecter à Amazon Timestream**

1. Commencez par créer un nouveau jeu de données. Choisissez **Data** dans le volet de navigation de gauche. 

1. Choisissez **Créer**, puis **Nouvel ensemble de données**.

1. Choisissez la carte de source de données Timestream.

1. Pour le **Nom de la source de données**, entrez un nom descriptif pour votre connexion à la source de données Timestream, par exemple `US Timestream Data`. Comme vous pouvez créer de nombreux jeux de données à partir d’une connexion à Timestream, il est préférable de choisir un nom simple.

1. Choisissez **Valider la connexion** pour vérifier la bonne connexion à Timestream.

1. Pour continuer, choisissez **Créer une source de données**.

1. Pour **Base de données**, cliquez sur **Sélectionner** pour afficher la liste des options disponibles. 

1. Choisissez celle que vous souhaitez utiliser, puis cliquez sur **Sélectionner** pour continuer. 

1. Effectuez l’une des actions suivantes :
   + Pour importer vos données dans le moteur en mémoire de Quick Sight (appeléSPICE), choisissez **Importer vers SPICE pour des analyses plus rapides**. 
   + Pour permettre à Quick Sight d'exécuter une requête sur vos données à chaque fois que vous actualisez le jeu de données ou que vous utilisez l'analyse ou le tableau de bord, choisissez **Directly query your data**. 

   Si vous désirez activer l’actualisation automatique sur un tableau de bord publié qui utilise des données Timestream, le jeu de données Timestream doit utiliser une requête directe.

1. Choisissez **Modifier/apercevoir**, puis **Enregistrer** pour enregistrer votre jeu de données et le fermer.

1. Répétez ces étapes pour le nombre de connexions directes simultanées à Timestream que vous souhaitez ouvrir dans un jeu de données. Supposons, par exemple, que vous souhaitiez utiliser quatre tables dans un jeu de données Quick Sight. Actuellement, les ensembles de données Quick Sight se connectent à une seule table à la fois à partir d'une source de données Timestream. Pour utiliser quatre tables dans le même jeu de données, vous devez ajouter quatre connexions à des sources de données dans Quick Sight. 

## Gérer des autorisations pour les données Timestream
<a name="dataset-permissions-for-timestream"></a>

La procédure suivante explique comment afficher, ajouter et révoquer des autorisations pour autoriser l’accès à la même source de données Timestream. Les personnes que vous ajoutez doivent être des utilisateurs actifs dans Quick Sight pour que vous puissiez les ajouter. 

**Modifier les autorisations sur un jeu de données**

1. Choisissez **Data** sur la gauche, puis faites défiler l'écran vers le bas pour trouver le jeu de données correspondant à votre connexion Timestream. On pourrait utiliser l’exemple `US Timestream Data`.

1. Choisissez le jeu de données **Timestream** pour l’ouvrir.

1. Sur la page de détails du jeu de données qui s’ouvre, sélectionnez l’onglet **Autorisations**.

   Une liste des autorisations actuelles s’affiche.

1. Pour ajouter des autorisations, choisissez **Ajouter des utilisateurs et des groupes**, puis procédez de la façon suivante :

   1. Ajoutez des utilisateurs ou des groupes pour leur permettre d’utiliser le même jeu de données.

   1. Lorsque vous avez terminé d’ajouter toutes les personnes que vous souhaitez ajouter, choisissez les **autorisations** que vous désirez appliquer.

1. (Facultatif) Pour modifier les autorisations, vous pouvez choisir **Visualiseur** ou **Propriétaire**. 
   + Choisissez **Visualiseur** pour autoriser l’accès en lecture.
   + Choisissez **Propriétaire** pour autoriser cet utilisateur à modifier, partager ou supprimer cette source de données Quick Sight. 

1. (Facultatif) Pour révoquer les autorisations, choisissez **Révoquer l’accès**. Une fois que vous avez révoqué l’accès d’un utilisateur, celui-ci ne peut pas créer, modifier, partager ou supprimer le jeu de données.

1. Lorsque vous avez terminé, choisissez **Fermer**.

## Ajout d'un nouveau jeu de données Quick Sight pour Timestream
<a name="create-dataset-using-timestream"></a>

Une fois que vous disposez d’une connexion à une source de données pour les données Timestream, vous pouvez créer des jeux de données Timestream à utiliser pour l’analyse. 

Actuellement, vous ne pouvez utiliser une connexion Timestream que pour un seul tableau d’un jeu de données. Pour ajouter des données provenant de plusieurs tables Timestream dans un seul jeu de données, créez une connexion à une source de données Quick Sight supplémentaire pour chaque table.

**Créer un jeu de données à l’aide d’Amazon Timestream**

1. Choisissez **Data** sur la gauche, puis faites défiler l'écran vers le bas pour trouver la carte de source de données pour votre connexion Timestream. Si vous avez de nombreuses sources de données, vous pouvez utiliser la barre de recherche en haut de la page pour trouver un correspondance partielle avec votre source de données.

1. Choisissez la carte de source de données **Timestream**, puis choisissez **Créer un jeu de données**.

1. Pour **Base de données**, cliquez sur **Sélectionner** pour afficher la liste des bases de données disponibles et choisissez celle que vous souhaitez utiliser.

1. Pour **Tableaux**, sélectionnez le tableau que vous souhaitez utiliser.

1. Choisissez **Modifier/apercevoir**.

1. (En option) Pour ajouter d’autres données, procédez comme suit : 

   1. Choisissez **Ajouter des données** en haut à droite.

   1. Pour vous connecter à différentes données, choisissez **Changer de source de données**, puis choisissez un autre jeu de données. 

   1. Suivez les instructions de l’interface utilisateur et terminez l’ajout de données. 

   1. Après avoir ajouté de nouvelles données au même jeu de données, sélectionnez **Configurer cette jointure** (les deux points rouges). Configurez une jointure pour chaque tableau supplémentaire. 

   1. Pour ajouter des champs calculés, Sélectionnez **Ajouter un champ calculé**. 

   1. Pour ajouter un modèle issu de SageMaker l'IA, choisissez **Augmenter avec SageMaker.** Cette option n'est disponible que dans l'édition Amazon Quick Enterprise.

   1. Décochez tous les champs que vous souhaitez omettre.

   1. Mettez à jour les types de données que vous souhaitez modifier.

1. Lorsque vous avez terminé, sélectionnez **Enregistrer** pour enregistrer et fermer le jeu de données. 

## Ajouter des données Timestream à une analyse
<a name="open-analysis-add-dataset-for-timestream"></a>

Vous trouverez ci-dessous comment ajouter un ensemble de données Amazon Timestream à une analyse Quick Sight. Avant de commencer, assurez-vous d’avoir un jeu de données existant qui contient les données Timestream que vous souhaitez utiliser.

**Ajouter des données Amazon Timestream à une analyse**

1. Choisissez **Analyses** sur la gauche.

1. Effectuez l’une des actions suivantes :
   + Pour créer une nouvelle analyse, choisissez **Nouvelle analyse** en haut à droite. 
   + Pour compléter une analyse existante, ouvrez l’analyse que vous désirez modifier. 
     + Choisissez l’icône de crayon en haut à gauche.
     + Choisissez **Ajouter un jeu de données**.

1. Choisissez le jeu de données Timestream que vous souhaitez ajouter.

Pour plus d’informations, consultez [Utilisation des analyses](https://docs.aws.amazon.com/quicksight/latest/user/working-with-analyses.html).