Méthode append()

Combine les lignes de deux ou plusieurs cadres de données en un seul cadre de données en concaténant un cadre de données en bas d'un autre cadre de données.

Syntaxe

nom_cadre_données_1.append(common_columns_only = True|False, all_chars = True|False, nom_cadre_données_2, nom_cadre_données_3, ...n)

Paramètres

Nom Description
common_columns_only = True | False
  • True seules les colonnes qui sont communes à tous les cadres de données concaténés sont incluses dans le cadre de données de sortie.

    Les colonnes du cadre de données sont considérées comme communes si elles portent un nom identique.

  • False toutes les colonnes de tous les cadres de données sont incluses dans le cadre de données de sortie. Les valeurs NaN apparaissent dans le cadre de données de sortie lorsqu'aucune colonne n'existe dans le cadre de données source.
all_chars = True | False
  • True convertit toutes les colonnes ne contenant pas de caractères dans tous les cadres de données concaténés au type de données de la chaîne.

    Cette conversion globale en données de la chaîne vérifie que toutes les colonnes ayant un nom identique sont concaténées sans erreur.

  • False le type de données des colonnes non caractères dans les cadres de données concaténés reste inchangé.
nom_cadre_données_2, nom_cadre_données_3, ...n

Cadre(s) de données à concaténer.

Les cadres de données sont concaténés dans l'ordre dans lequel vous les indiquez. Le cadre de données de sortie contient les lignes du cadre_de_données_1, suivies des lignes du cadre_de_données_2, etc.

Les cadres de données sources peuvent avoir des colonnes différentes ou identiques.

Renvoie

Un cadre de données HCL.

Exemples

Concaténer des cadres de données avec des structures de données identiques

Vous concaténez les cadres de données Trans_Jan, Trans_Feb et Trans_Mar dans un seul cadre de données appelé Trans_Q1 qui inclut toutes les lignes des trois cadres de données sources.

Les cadres de données sources présentent tous un jeu identique de colonnes, de sorte que le fait de spécifier True ou False pour common_columns_only n'a pas d'importance.

Trans_Q1 = Trans_Jan.append(common_columns_only = False, all_chars = False, Trans_Feb, Trans_Mar)

Concaténer des cadres de données avec des structures de données différentes

Vous disposez de cadres de données distincts contenant les données relatives aux employés des différentes divisions d'une entreprise. Vous avez besoin de toutes les données sur les employés dans un seul cadre de données afin d'effectuer une analyse. La plupart des colonnes sont les mêmes pour tous les cadres de données, mais certaines colonnes non requises pour votre analyse sont propres à chaque cadre de données.

Vous utilisez common_columns_only pour préciser que seules les colonnes qui sont identiques dans tous les cadres de données sont incluses dans le cadre de données de sortie. Si une colonne n'est pas présente, même dans un des cadres de données, elle est omise de la sortie.

Employees_All = Employees_HQ.append(common_columns_only = True, all_chars = False, Employees_West, Employees_South)