Skip to content

Basic test functions for interacting with a CosmosDB REST API using the DocumentDB protocols in R

License

Notifications You must be signed in to change notification settings

aaron2012r2/cosmosR

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

61 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

cosmosR

Basic functions in R for simple interactions with a CosmosDB REST API using Document-based storage.

Cosmos DB Intro

More information can be found at Microsoft's website.
I wrote this specifically for a Cosmos DB using the Document DB protocol via the REST API.

Getting Started

First, source the R file to load all functions. Next, you'll need the key to a Cosmos DB. If using all my default parameters, follow the steps below to perform "SELECT * FROM c" from the database

cosmosAuth("KeyGoesHere", "uri", "dbName", "collName")
list.all.documents <- cosmosQuery(content.response = TRUE)

This provides a list named list.all.documents which contains the full contents of all documents retrieved, and only the documents. No metadata about the HTTP response is stored.

Query Target

As of 10-Jul-2017 the cosmosQuery function accepts basic parameters to target any db and collection in a Cosmos DB to which you have access. No guarantees are made, however, since this feature is new.

Create Document

You can also create a document, by using the cosmosCreate() function. (Note that the partition key value is required by CosmosDB both as value in argument and as key=value in the document.)

cosmosAuth("KeyGoesHere", "uri", "dbName", "collName")
sql_doc <- list(
    id = "unique-id",
    code = "code-1"
)
data <- cosmosCreate(sql.doc = sql_doc, sql.partitionkey_value = "code-1", content.response = TRUE)

Custom parameters

Queries can be constructed and will always SELECT from "c," the full Cosmos DB, at this time. These are built using the constructQuery function.

About

Basic test functions for interacting with a CosmosDB REST API using the DocumentDB protocols in R

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages