> ## Documentation Index > Fetch the complete documentation index at: https://docs.kinetica.com/llms.txt > Use this file to discover all available pages before exploring further. # gpudbfilehandler > gpudbfilehandler — Kinetica Python API

Class GPUdbFileHandler

class gpudb.GPUdbFileHandler(db: GPUdb)

This class exposes convenience methods to upload/download files to/from KIFS from local/KIFS directory.

Methods

  1. upload\_files - Upload a list of files - upload\_files()

  2. upload\_file - Upload a single file - upload\_file()

  3. download\_files - Download a list of files - download\_files()

  4. download\_file - Download a single file - download\_file()

Example

``` file_handler = GPUdbFileHandler.from_url_info(host = "http://127.0.0.1.2:9191", username="user", password="password") file_handler.upload_file(file_name="/home/user/some_file_name", kifs_path="~anonymous") file_handler.download_file(file_name="~anonymous/some_file_name", local_dir="/home/user/download") ```

Initialize a GPUdbFileHandler.

Parameters

db (GPUdb) –

A GPUdb instance

classmethod from\_url\_info(host: str = '[http://127.0.0.1:9191](http://127.0.0.1:9191)', username: str = None, password: str = None)

Create a GPUdbFileHandler instance from a host URL, user name, and password.

Parameters

host (str, optional) –

A Kinetica host URL. Defaults to “[http://127.0.0.1:9191](http://127.0.0.1:9191)”.

username (str, optional) –

Kinetica user name. Defaults to None.

password (str, optional) –

Password for the user. Defaults to None.

Returns

GPUdbFileHandler –

a GPUdbFileHandler instance

classmethod from\_db\_instance(db: GPUdb)

Create a GPUdbFileHandler from a GPUdb instance.

Parameters

db (GPUdb) –

a GPUdb instance

Returns

GPUdbFileHandler –

a GPUdbFileHandler instance

upload\_file(file\_name: str, kifs\_path: str) → None

Upload a single file to a KIFS directory.

Parameters

file\_name (str) –

Full path to the local file to upload

kifs\_path (str) –

A KIFS directory to upload (must be existing)

upload\_files(file\_names: list, kifs\_path: str) → None

Upload a list of files to a KIFS directory.

Parameters

file\_names (list) –

List of full local file paths

kifs\_path (str) –

Name of an existent KIFS directory

download\_file(file\_name: str, local\_dir: str) → None
Download a single file to a local directory.

A large file greater than 60MB in size will be downloaded in parts.

Parameters

file\_name (str) –

Name of the file to download (full KIFS path)

local\_dir (str) –

Name of the local directory to save the file in

Raises

gpudb.GPUdbException –

In case of an exception thrown by the server or in case the local directory doesn’t exist

download\_files(file\_names: list, local\_dir: str) → None

Download a list of files from KIFS.

Parameters

file\_names (list) –

A list of file names (full KIFS paths)

local\_dir (str) –

Name of the local directory to save the files in

Raises

gpudb.GPUdbException –

In case of an exception thrown by the server or in case the local directory doesn’t exist