IMPORTRANGE

Importe une plage de cellules depuis une feuille de calcul spécifiée.

Exemple d'utilisation

IMPORTRANGE("https://docs.google.com/spreadsheets/d/abcd123abcd123"; "Feuille1!A1:C10")

IMPORTRANGE(A2;"B2")

Faites référence à un tableau : IMPORTRANGE("https://docs.google.com/spreadsheets/d/abcd123abcd123", "DeptSales[Sales Amount]") En savoir plus sur l'utilisation des tableaux dans Google Sheets

Utilisez une plage nommée : IMPORTRANGE("https://docs.google.com/spreadsheets/d/abcd123abcd123", "Sales_total") Découvrez comment nommer une plage de cellules.

Syntaxe

IMPORTRANGE(url_feuille; chaîne_plage)

• url_feuille : URL de la feuille de calcul contenant les données à importer.

  • La valeur url_feuille doit être mise entre guillemets ou doit faire référence à une cellule contenant l'URL d'une feuille de calcul.

• chaîne_plage : chaîne au format "[nom_feuille!]plage" (par exemple "Feuille1!A2:B6" ou "A2:B6") spécifiant la plage à importer.

  • L'élément nom_feuille de chaîne_plage est facultatif. Par défaut, la fonction IMPORTRANGE importe la plage indiquée à partir de la première feuille.

  • La valeur chaîne_plage doit être mise entre guillemets ou doit faire référence à une cellule contenant le texte correspondant.

Détails techniques et bonnes pratiques

Toute modification apportée à la fonction IMPORTRANGE du document source entraîne l'actualisation de tous les documents destinataires ouverts et l'affichage d'une barre de chargement verte. IMPORTRANGE attend également que les calculs se terminent sur le document source avant de renvoyer les résultats au document destinataire, même s'il n'y a aucun calcul à effectuer dans la plage source.

Bonnes pratiques

• Limitez le nombre de feuilles destinataires, car chaque feuille destinataire doit être lue à partir de la feuille source.
• Restructurez et condensez les résultats avant d'utiliser IMPORTRANGE, en particulier si vous importez une feuille régulièrement mise à jour.
  • Par exemple, votre objectif est de calculer la somme de 1 000 000 lignes dans une autre feuille de calcul. Il est plus rapide de calculer la somme sur cette feuille de calcul, puis d'utiliser IMPORTRANGE pour récupérer cette somme à nombre unique, plutôt que d'utiliser IMPORTRANGE pour transférer directement les 1 000 000 lignes de données et calculer la somme dans votre feuille de calcul. Cette méthode permet de condenser et d'agréger les informations pour IMPORTRANGE avant de les transférer.

Les modifications IMPORTRANGE peuvent se propager à d'autres feuilles lorsque celles-ci sont enchaînées. Si la feuille B comporte IMPORTRANGE(feuille A) et la feuille C comporte IMPORTRANGE(feuille B), une chaîne est créée. Toute modification apportée à la feuille A entraîne l'actualisation de la feuille B et de la feuille C.

Bonnes pratiques

• Limitez les chaînes IMPORTRANGE sur plusieurs feuilles.
• Évitez les cycles IMPORTRANGE. Par exemple, vous créez un cycle si vous utilisez IMPORTRANGE sur plusieurs feuilles de calcul qui font référence les unes aux autres : la feuille de calcul A utilise IMPORTRANGE sur les données de la feuille de calcul B, et la feuille de calcul B utilise également IMPORTRANGE pour récupérer les données de la feuille de calcul A. Cela crée une boucle, dans laquelle chacune tente en permanence de référencer l'autre et ne génère jamais de sortie de données réelle.
• Il existe un délai entre le moment où la feuille source est modifiée et le moment où la feuille concernée reflète cette modification. Cela signifie que plusieurs instances de IMPORTRANGE sur une chaîne de plusieurs documents peuvent entraîner un long délai entre la modification de la feuille source et l'affichage du résultat sur la feuille destinataire.

IMPORTRANGE s'actualise lorsqu'un document a été ouvert pour la première fois ou au cours des cinq dernières minutes. Donc, comme avec la chaîne de modifications, IMPORTRANGE doit "réveiller" tous les documents à partir desquels elle importe des données.

Bonnes pratiques

• Notez que l'activation des documents peut prendre un certain temps. Envisagez de limiter les chaînes IMPORTRANGE.

Autorisation et accès

Il est nécessaire d'autoriser explicitement les feuilles de calcul à extraire les données d'autres feuilles via IMPORTRANGE. Lorsqu'une feuille de destination extrait pour la première fois des données à partir d'une nouvelle feuille source, un message s'affiche pour demander à l'utilisateur d'autoriser cet accès.

Si vous essayez d'utiliser IMPORTRANGE pour transférer des données à partir d'une feuille de calcul dont vous êtes le propriétaire, le message suivant s'affiche :

1. Patientez quelques secondes après avoir exécuté votre fonction IMPORTRANGE.
2. Un message d'erreur #REF! s'affiche : "Vous devez associer ces feuilles. Autorisez l'accès."
3. Pour autoriser l'accès à la feuille de calcul source, cliquez sur Autoriser l'accès.

Si vous essayez d'utiliser IMPORTRANGE pour transférer des données à partir d'une feuille de calcul dont vous n'êtes pas le propriétaire, le message suivant s'affiche quelques secondes :

1. Saisissez l'URL de votre feuille de calcul source dans le navigateur.
2. Demandez à accéder à la feuille de calcul.
3. Attendez que le propriétaire de la feuille de calcul vous accorde l'accès.

Une fois l'autorisation accordée, tous les éditeurs de la feuille de calcul de destination peuvent utiliser IMPORTRANGE pour extraire des données à partir de n'importe quelle partie de la feuille de calcul source. L'autorisation d'accès reste valide jusqu'à ce que l'utilisateur qui l'a accordée soit supprimé de la source. Notez que l'accès accordé à la feuille de destination est comptabilisé dans la limite de partage de 600 utilisateurs pour la feuille source.

Performances

IMPORTRANGE est une fonction de données externe, comme IMPORTXML et GOOGLEFINANCE. Cela signifie qu'une connexion Internet est nécessaire à son fonctionnement. Sheets doit télécharger l'ensemble de la plage sur votre ordinateur et sera affecté par un réseau lent. Les données reçues sont limitées à 10 Mo par requête. Si vous constatez un ralentissement des performances avec IMPORTRANGE, envisagez de limiter la taille des plages importées. Vous pouvez également effectuer une synthèse des calculs dans le document source afin de réduire le volume de données transférées vers votre feuille locale et qu'une plus grande partie du calcul soit effectuée à distance.

Conseil : Vous pouvez utiliser d'autres outils. Apps Script peut lire les données d'autres documents et peut être déclenché lors de modifications ou selon une planification prédéfinie. Les feuilles connectées proposent une actualisation programmée. Elles sont également mieux adaptées aux chargements et aux importations d'ensembles de données volumineux.

Limites d'utilisation

Lorsque les fonctions IMPORTRANGE génèrent trop de trafic, il est possible que le message "Chargement" s'affiche dans la cellule et que vous obteniez le message d'erreur détaillé suivant : "En raison du nombre important de demandes, le chargement des données peut prendre un certain temps. Essayez de réduire le nombre de fonctions IMPORTHTML, IMPORTDATA, IMPORTFEED ou IMPORTXML dans les différentes feuilles de calcul que vous avez créées."

Ces limites sont appliquées au créateur du document. L'utilisateur doit prendre en compte la somme de toutes les fonctions d'importation utilisées dans tous les documents ouverts qu'il crée. Les modifications apportées par un collaborateur peuvent également être comptabilisées dans votre quota.

Pour résoudre le message d'erreur, nous recommandons aux utilisateurs de réduire la fréquence des demandes d'actualisation des données dans la fonction d'importation. Par exemple, si la valeur de l'argument résolu dans =IMPORTRANGE(arg) change fréquemment, de nombreux appels externes peuvent être émis, ce qui peut entraîner une limitation.

Fraîcheur des données

Google Sheets permet aux utilisateurs de Sheets de recevoir des données à jour tout en restant raisonnables dans leur utilisation. IMPORTRANGE recherche automatiquement les modifications toutes les heures lorsque le document est ouvert, même si la formule et la feuille de calcul ne changent pas. Si vous supprimez et rajoutez des cellules ou écrasez les cellules avec la même formule, une actualisation des fonctions est déclenchée. L'ouverture et l'actualisation du document n'entraînent pas l'actualisation de IMPORTRANGE.

Volatilité

Lorsque vous utilisez IMPORTRANGE, il est possible que le message "#ERROR!" s'affiche dans une cellule comportant le message détaillé suivant : "Cette fonction ne doit pas faire référence à une cellule contenant NOW, RAND ou RANDBETWEEN". Les fonctions d'importation ne peuvent pas référencer directement ou indirectement une fonction volatile telle que NOW, RAND ou RANDBETWEEN. Cela évite de surcharger la feuille de calcul de nos utilisateurs, car ces fonctions volatiles sont mises à jour fréquemment.

Remarque : La seule exception concerne la fonction TODAY, qui est volatile, mais ne se met pas à jour plus d'une fois par jour.

Voici quelques recommandations :

1. Copiez le résultat de ces fonctions volatiles.
2. Utilisez Effectuer un collage spécialValeurs uniquement.
3. Référencez ces valeurs statiques.

Dans ce cas, toutes les valeurs deviennent statiques. Par exemple, si vous copiez et effectuez un collage spécial pour les résultats NOW en tant que valeurs, les valeurs que vous collez ne changent plus.

Si vous avez d'autres questions, vous pouvez consulter la Communauté d'aide des éditeurs Google Docs pour obtenir de l'aide.

Voir également

IMPORTXML : Importe des données depuis des types de données structurées tels que XML, HTML, CSV, TSV et des flux RSS et ATOM XML.

IMPORTHTML : Importe des données depuis un tableau ou une liste dans une page HTML.

IMPORTFEED : Importe un flux RSS ou ATOM.

IMPORTDATA : Importe des données d'une URL donnée au format .csv (valeurs séparées par des virgules) ou .tsv (valeurs séparées par des tabulations).

Découvrez comment optimiser vos références de données.