ANALYZE - Amazon Redshift

ANALYZE

Met à jour les statistiques de table pour une utilisation par le planificateur de requête.

Syntax

ANALYZE [ VERBOSE ] [ [ table_name [ ( column_name [, ...] ) ] ] [ PREDICATE COLUMNS | ALL COLUMNS ]

Parameters

VERBOSE

Clause qui renvoie des messages d'information d'avancement relatifs à l'opération ANALYZE. Cette option est utile lorsque vous ne spécifiez pas une table.

table_name

Vous pouvez analyser des tables spécifiques, y compris les tables temporaires. Vous pouvez qualifier la table avec son nom de schéma. Vous pouvez le cas échéant spécifier un nom_table pour analyser une seule table. Vous ne pouvez pas spécifier plus d'un nom_table avec une seule instruction ANALYZE nom_table. Si vous ne spécifiez pas un table_name, toutes les tables de la base de données actuellement connectée sont analysées, y compris les tables persistantes du catalogue système. Amazon Redshift ignore l'analyse d'une table si le pourcentage de lignes qui ont été modifiées depuis la dernière opération ANALYZE est inférieur au seuil d'analyse. Pour de plus amples informations, veuillez consulter Seuil d'analyse.

Vous n'avez pas besoin d'analyser les tables système Amazon Redshift (tables STL et STV).

column_name

Si vous spécifiez un nom_table, vous pouvez également spécifier une ou plusieurs colonnes de la table (au forme de liste de colonnes séparées entre parenthèses). Si une liste de colonnes est spécifiée, seules les colonnes de la liste sont analysées.

PREDICATE COLUMNS | ALL COLUMNS

Clauses qui indiquent si ANALYZE doit inclure uniquement les colonnes de prédicat. Spécifiez PREDICATE COLUMNS pour analyser uniquement les colonnes qui ont été utilisées comme prédicats dans des requêtes précédentes ou qui sont susceptibles d'être utilisées comme prédicats. Spécifiez ALL COLUMNS pour analyser toutes les colonnes. La valeur par défaut est ALL COLUMNS.

Une colonne est incluse dans l'ensemble de colonnes de prédicat si l'une des conditions suivantes est vraie :

  • La colonne a été utilisée dans une requête dans le cadre d'un filtre, d'une condition de jointure ou d'une clause group by.

  • La colonne est une clé de distribution.

  • La colonne fait pas partie d'une clé de tri.

Si aucune colonne n'est marquée comme colonne de prédicat, par exemple, parce que la table n'a pas encore été interrogée, toutes les colonnes sont analysées même si PREDICATE COLUMNS est spécifié. Pour plus d'informations sur les colonnes de prédicat, consultez Analyse des tables.

Notes d'utilisation

Amazon Redshift exécute automatiquement les tables que vous créez avec les commandes suivantes :

  • CREATE TABLE AS

  • CREATE TEMP TABLE AS

  • SELECT INTO

Vous ne pouvez pas analyser une table externe.

Vous n'avez pas besoin d'exécuter la commande ANALYZE sur ces tables lorsqu'elles sont créées initialement. Si vous les modifiez, vous devez les analyser de la même manière que les autres tables.

Seuil d'analyse

Pour réduire le temps de traitement et améliorer les performances globales du système, Amazon Redshift ignore ANALYZE pour une table si le pourcentage de lignes qui ont été modifiées depuis l'exécution de la dernière opération ANALYZE est inférieur au seuil d'analyse spécifié par le paramètre analyze_threshold_percent. Par défaut, analyze_threshold_percent est 10. Pour modifier analyze_threshold_percent de la session en cours, exécutez la commande SET. L'exemple suivant passe de analyze_threshold_percent à 20 %.

set analyze_threshold_percent to 20;

Pour analyser des tables lorsque seul un petit nombre de lignes a changé, définissez analyze_threshold_percent sur un petit nombre arbitraire. Par exemple, si vous définissez analyze_threshold_percent sur 0,01, une table avec 100 000 000 lignes n'est pas ignorée si au moins 10 000 lignes ont été modifiées.

set analyze_threshold_percent to 0.01;

Si ANALYZE ignore une table, car il ne respecte pas le seuil d'analyse, Amazon Redshift renvoie le message suivant.

ANALYZE SKIP

Pour analyser toutes les tables même si aucune ligne n'a été modifiée, définissez analyze_threshold_percent sur 0.

Pour afficher les résultats des opérations ANALYZE, interrogez la table système STL_ANALYZE.

Pour plus d'informations sur l'analyse des tables, consultez Analyse des tables.

Examples

Analysez toutes les tables de la base de données TICKIT et renvoyez les informations d'avancement.

analyze verbose;

Analysez la table LISTING uniquement.

analyze listing;

Analysez les colonnes VENUEID et VENUENAME de la table VENUE.

analyze venue(venueid, venuename);

Analysez uniquement les colonnes de prédicat de la table VENUE.

analyze venue predicate columns;