Skip to content

Business intelligence made simple

Added experimental support for Salesforce

Andrew Kane3fd0a7c634aa
diff --git a/CHANGELOG.md b/CHANGELOG.md
index e4cac1ab..78c0e2b1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,7 @@
## 2.0.2 [unreleased]
- Added support for variable transformation for blind indexing
+- Added experimental support for Salesforce
- Fixed JavaScript sorting for numbers with commas
## 2.0.1
diff --git a/README.md b/README.md
index b12504ea..520bf24b 100644
--- a/README.md
+++ b/README.md
@@ -478,6 +478,7 @@ data_sources:
- [Oracle](#oracle)
- [PostgreSQL](#postgresql-1)
- [Presto](#presto)
+- [Salesforce](#salesforce-experimental-master) [experimental, master]
- [Snowflake](#snowflake)
- [SQLite](#sqlite)
- [SQL Server](#sql-server)
@@ -619,6 +620,29 @@ data_sources:
url: presto://user@hostname:8080/catalog
```
+### Salesforce [experimental, master]
+
+Add [restforce](https://github.com/restforce/restforce) to your Gemfile and set:
+
+```yml
+data_sources:
+ my_source:
+ adapter: salesforce
+```
+
+And set the appropriate environment variables:
+
+```sh
+SALESFORCE_USERNAME="username"
+SALESFORCE_PASSWORD="password"
+SALESFORCE_SECURITY_TOKEN="security token"
+SALESFORCE_CLIENT_ID="client id"
+SALESFORCE_CLIENT_SECRET="client secret"
+SALESFORCE_API_VERSION="41.0"
+```
+
+Supports [SOQL](https://developer.salesforce.com/docs/atlas.en-us.soql_sosl.meta/soql_sosl/sforce_api_calls_soql.htm)
+
### Snowflake
First, install the [ODBC driver](https://docs.snowflake.net/manuals/user-guide/odbc.html). Add [odbc_adapter](https://github.com/localytics/odbc_adapter) to your Gemfile and set:
diff --git a/lib/blazer.rb b/lib/blazer.rb
index 159faf3e..0a7ac22f 100644
--- a/lib/blazer.rb
+++ b/lib/blazer.rb
@@ -20,6 +20,7 @@ require "blazer/adapters/druid_adapter"
require "blazer/adapters/elasticsearch_adapter"
require "blazer/adapters/mongodb_adapter"
require "blazer/adapters/presto_adapter"
+require "blazer/adapters/salesforce_adapter"
require "blazer/adapters/sql_adapter"
require "blazer/adapters/snowflake_adapter"
@@ -220,5 +221,6 @@ Blazer.register_adapter "druid", Blazer::Adapters::DruidAdapter
Blazer.register_adapter "elasticsearch", Blazer::Adapters::ElasticsearchAdapter
Blazer.register_adapter "presto", Blazer::Adapters::PrestoAdapter
Blazer.register_adapter "mongodb", Blazer::Adapters::MongodbAdapter
+Blazer.register_adapter "salesforce", Blazer::Adapters::SalesforceAdapter
Blazer.register_adapter "sql", Blazer::Adapters::SqlAdapter
Blazer.register_adapter "snowflake", Blazer::Adapters::SnowflakeAdapter
diff --git a/lib/blazer/adapters/salesforce_adapter.rb b/lib/blazer/adapters/salesforce_adapter.rb
new file mode 100644
index 00000000..9a4eae7c
--- /dev/null
+++ b/lib/blazer/adapters/salesforce_adapter.rb
@@ -0,0 +1,42 @@
+module Blazer
+ module Adapters
+ class SalesforceAdapter < BaseAdapter
+ def run_statement(statement, comment)
+ columns = []
+ rows = []
+ error = nil
+
+ # remove comments manually
+ statement = statement.gsub(/--.+/, "")
+ # only supports single line /* */ comments
+ # regex not perfect, but should be good enough
+ statement = statement.gsub(/\/\*.+\*\//, "")
+
+ begin
+ response = client.query(statement)
+ rows = response.map { |r| r.to_hash.except("attributes").values }
+ columns = rows.any? ? response.first.to_hash.except("attributes").keys : []
+ rescue => e
+ error = e.message
+ end
+
+ [columns, rows, error]
+ end
+
+ def tables
+ # cache
+ @tables ||= client.describe.select { |r| r.queryable }.map(&:name)
+ end
+
+ def preview_statement
+ "SELECT Id FROM {table} LIMIT 10"
+ end
+
+ protected
+
+ def client
+ @client ||= Restforce.new
+ end
+ end
+ end
+end