Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Aypak/dbhelpers
Helper Functions for Common Database Operations in R
https://github.com/Aypak/dbhelpers
database pool-connection postgresql r-package schema
Last synced: 3 months ago
JSON representation
Helper Functions for Common Database Operations in R
- Host: GitHub
- URL: https://github.com/Aypak/dbhelpers
- Owner: Aypak
- License: gpl-3.0
- Created: 2020-06-26T09:11:25.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-03-19T11:30:24.000Z (8 months ago)
- Last Synced: 2024-06-05T01:45:02.681Z (5 months ago)
- Topics: database, pool-connection, postgresql, r-package, schema
- Language: R
- Homepage: https://aypak.github.io/dbhelpers/
- Size: 146 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- jimsghstars - Aypak/dbhelpers - Helper Functions for Common Database Operations in R (R)
README
# dbhelpers
> Helper functions to make working with databases a bit smoother
[](https://github.com/Aypak/dbhelpers/actions)
## Overview
This package provides some functions to help work with (mostly PostgreSQL) databases, and to help clean your data.
(This package has not yet been listed on CRAN)
Installation :
```r
# Download latest release zip file
install.packages("",repos = NULL)
# From Github
# install.packages("devtools")
devtools::install_github("Aypak/dbhelpers")
```
## Functions available :
- [connect_to_pg](#connect_to_pg)
- [read_files_into_df](#read_files_into_df)
- [create_lazy_conn](#create_lazy_conn)
- [lazy_conn_all_tables](#lazy_conn_all_tables)
- [get_first_name](#get_first_name)
- [get_last_name](#get_last_name)
#### read_files_into_df
Read multiple files from a directory into a single dataframe. Essentially binding the contents of the files and filling missing columns with NA.
e.g
```r
raw_data <- read_files_into_df(file_directory="raw_csv_files",file_pattern="*.csv")
```
#### create_lazy_conn
Create a connection to a database table using a database pool object. The connection is exactly like a pool connection. It does not retreive any data until it is explicitly called.
##### Example:
Assume there is a [pool connection](https://db.rstudio.com/pool) to a PostgreSQL database called books_conn in the workspace.
In the public schema, the database contains the tables:
users,books,transactions
```r
# If we want to create a connection to the users table
users <- create_lazy_conn(books_conn, schemaname = "public", "users")
```
#### lazy_conn_all_tables
Create connections the same as the [create_lazy_conn](#create_lazy_conn) function for all tables in a specified schema. The connections will have the same names as the tables they are connected to.
Following the example above:
```r
# create connections to all tables in the public schema in the global environment
lazy_conn_all_tables(books_conn,schemaname = "public", prefix = "", env = globalenv())
# This will create the connection objects: users, books, transactions
```
#### get_first_name
Get the first name from a full name separated by spaces
e.g
```r
get_first_name("John Banda")
# [1] "John"
```
#### get_last_name
Get the last name from a full name separated by spaces. If there are middle names, all of the middle names and last name will be taken as the last name.
e.g
```r
get_last_name("John Bewzani Banda")
# [1] "Bewzani Banda"
```