read_csv() methode
Leest een bestand met door komma's gescheiden waarden (*.csv) of een tekstbestand (*.txt) naar een HCL-dataframe.
Syntaxis
hcl.read_csv(source file, nrows = number_of_rows, usecols = ["column name", "...n"], header = number_of_header_rows, names = ["column name", "...n"], delimiter = "separator character", index_col = ["column name", "...n"], multiple additional parameters)
Parameters
| Naam | Beschrijving |
|---|---|
| bronbestand |
De naam, het bestandspad of de URL van het bronbestand, inclusief de bestandsextensie (*.csv or *.txt). |
|
nrows = number_of_rows optioneel |
Het aantal rijen dat moet worden gebruikt. Rijen worden geteld vanaf het begin van het bestand, beginnend bij 0. Als dit wordt weggelaten, worden alle rijen in het bronbestand gebruikt. |
|
usecols = ["column name", "...n"] optioneel |
De te gebruiken kolommen. If omitted, all columns in the source file are used. Geef de kolomnamen exact op zoals ze in het bronbestand voorkomen, tenzij u andere namen opgeeft met names. Als u verschillende namen opgeeft, gebruik dan die namen met usecols. De resulterende volgorde van de kolommen in het dataframe is dezelfde als hun volgorde in het bronbestand, ongeacht de volgorde waarin u ze specificeert. |
|
header = number_of_header_rows optioneel |
Sluit een of meer kopregelregels in het bronbestand uit van het dataframe. |
|
names = ["column name", "...n"] optioneel |
Kolomnamen om te gebruiken in het dataframe. Geeft kolomnamen op als er geen namen in het bronbestand bestaan, of overschrijft de namen in het bronbestand. De namen die u opgeeft, worden opeenvolgend toegepast op de kolommen in de gegevens, dus zorg ervoor dat de namen en kolommen correct zijn uitgelijnd. Opmerking Gebruik de header-parameter om te voorkomen dat bestaande kolomnamen worden opgenomen in het dataframe. Bijvoorbeeld: specificeer header = 0 als de kolomnamen op de eerste regel van het bronbestand staan. |
|
delimiter = "separator character" optioneel |
Het scheidingsteken dat tussen waarden in het bronbestand wordt gebruikt als dit geen komma is. Kwalificeer het scheidingsteken met aanhalingstekens. scheidingsteken = "|" Tab-scheidingsteken: scheidingsteken = "\t" Als de komma als scheidingsteken wordt weggelaten, wordt ( , ) gebruikt. |
|
index_col = ["column name", "...n"] optioneel |
Gebruikt een van de gegevenskolommen in het bronbestand als indexkolom in het dataframe. Maakt het mogelijk om meer dan één indexkolom op te geven. |
| meerdere aanvullende parameters
optioneel |
hcl.read_csv() ondersteunt alle parameters die worden ondersteund door de Pandas-functie pandas.read_csv(). Voor een volledige lijst met parameters kunt u de Pandas-documentatie voor pandas.read_csv() raadplegen. |
Retourneert
HCL-dataframe.
Voorbeelden
Een CSV-bestand naar een HCL-dataframe lezen
U wilt alle gegevens – alle rijen en alle kolommen – uit het bestand Pcard_Transactions.csv lezen naar het pcard_transactions-dataframe. De kolomnamen uit het bron-CSV-bestand worden gebruikt in het dataframe. Omdat het bronbestand een komma ( , ) gebruikt als scheidingsteken tussen waarden, hoeft u het scheidingsteken niet op te geven.
pcard_transactions = hcl.read_csv("https://help.highbond.com/analytics/Pcard_Transactions.csv")
Lees een deelverzameling van rijen en kolommen uit een CSV-bestand naar een HCL-dataframe
U wilt slechts een subset van de gegevens uit het bestand Pcard_Transactions.csv inlezen in het pcard_transactions-dataframe. Het onderstaande voorbeeld leest alleen de eerste 100 rijen en de opgegeven kolommen.
pcard_transactions = hcl.read_csv("https://help.highbond.com/analytics/Pcard_Transactions.csv", nrows = 100, usecols = ["AccountNumber", "Amount", "Description", "Quantity", "TransDate", "UnitCost", "VendorLocation","VendorName", "VendorNumber"])
Een tekstbestand met tabs als scheidingsteken naar een HCL-dataframe lezen
U moet gegevens lezen uit het tabgescheiden bestand Pcard_Transactions.txt naar het pcard_transactions-dataframe. De kolomnamen uit het brontekstbestand worden gebruikt in het dataframe. Omdat het bronbestand een tab gebruikt als scheidingsteken tussen waarden, moet u het scheidingsteken specificeren ( "\t" ).
pcard_transactions = hcl.read_csv("https://help.highbond.com/analytics/Pcard_Transactions.txt", delimiter = "\t")
Een CSV-bestand naar een HCL-dataframe lezen en de kolomnamen bijwerken
U wilt de gegevens uit het bestand Pcard_Transactions.csv inlezen in het dataframe pcard_transactions en daarbij uw eigen kolomnamen opgeven in plaats van de kolomnamen uit het bronbestand te gebruiken.
Naast het specificeren van verschillende kolomnamen, moet u header = 0 opgeven om te voorkomen dat de bronkolomnamen op de eerste regel van het bronbestand in het dataframe worden opgenomen.
pcard_transactions = hcl.read_csv("https://help.highbond.com/analytics/Pcard_Transactions.csv", header = 0, names = ["Acct_Num", "Amount", "Currency", "Country", "Desc", "Merch_Code", "Qty", "Ref_Num", "Currency_Src", "Trans_Date", "Unit_Cost", "Vend_Loc", "Vend_Name", "Vend_Num"])
Een CSV-bestand naar een HCL-dataframe lezen en kopregelinformatie uitsluiten
U wilt de gegevens uit het bestand Pcard_Transactions.csv inlezen in het dataframe pcard_transactions, waarbij u drie regels met koptekstinformatie in het bronbestand overslaat.
pcard_transactions = hcl.read_csv("https://help.highbond.com/analytics/Pcard_Transactions.csv", header = 3)
