- Startup
- Business
- Enterprise
- On-Premise
- Add-on
Overview
Etlworks Marketo connector allows fast, real-time access to Marketo data. The connector supports most of the objects available through the Marketo API, and it works just like any other database connector.
Etlworks partnered with CData to provide access to the Marketo API using industry-standard JDBC protocol. Read about CData Marketo JDBC connector.
When to use Marketo connector
Use this connector to create Flows that work with data in Marketo.
Prerequisites
- Enable Marketo connector for your Etlworks Integrator account. Contact
support@etlworks.com
to enable connector. - Obtain the
OAuthClientId
andOAuthClientSecret
values. To do this, navigate to theLaunchPoint
option on the Admin area. Click theView Details
link for the desired service, and a window containing the authentication credentials will be displayed. - Obtain the REST Endpoint URL, which can be found on your Marketo Admin area, specifically on the
Integration
>Web Services
option in the REST API section. TheIdentity Endpoint
will not be needed.
Create a Connection
Follow the steps below in creating a Marketo Connection:
Step 1. In the Connections
window, click +
, and type in marketo
.
Step 2. Enter the following Connection parameters:
URL
: the JDBC Connection string. Typically, you only need to replace<instance>
with the Marketo instance name, for example,177-FXY-123
.Client ID
: the OAuth2 client ID.Client Secret
: the OAuth2 secret. Read about Marketo API client ID and client secret.Other Parameters
: optional parameters askey=value
pairs.
Use Other parameters
to specify the Connection string options. Read about available Connection string options.
Marketo data model
Read about the Marketo REST API data model, specifically, the filters required to retrieve data from some objects.
Stored procedures
Stored Procedures are available to complement the data available from the REST Data Model. Sometimes, it is necessary to update the data available from a view using a stored procedure because it does not provide direct, table-like, two-way updates. In these situations, the data retrieval is done using the appropriate view or table, while the update is done by calling a Stored Procedure. Stored Procedures take a list of parameters and return a dataset that contains the collection of tuples that constitute the response.
Read about available Stored Procedures.
To call stored procure from the SQL Flow or the Before/After SQL, use EXEC sp_name params=value
syntax.
For example:
EXEC SelectEntries ObjectName = 'Account'
Work with data in Marketo
Extract data from Marketo
Extracting data from Marketo is similar to extracting data from the relational database.
Here's a detailed instruction on how to extract data from Marketo:
Step 1. Create Marketo Connection that will be used as a source (FROM
).
Step 2. Create a destination Connection, for example, a Connection to the relational database, and if needed, a Format (Format is not needed if the destination is a database or well-known API).
Step 3. Create a Flow where the source is a database, and the destination is a Connection created in step 2, for example, a relational database.
Step 4. Add new source-to-destination transformation.
Step 5. Select the Marketo Connection created in step 1 as a source Connection, and select the Marketo object you are extracting data from.
Step 6. Select TO
Connection, Format (if needed), and object (for example database table) to load data into.
Step 7. Click MAPPING
and optionally enter Source query
(you don't need a query if you are extracting data from the Marketo object unconditionally).
Step 8. Optionally, define the per-field Mapping.
Step 9. Add more transformations, if needed.
Load data in Marketo
Loading data in Marketo is similar to loading data into a relational database.
Here's a step by step instruction on how to load data in Marketo:
Step 1. Create a source Connection and a Format (if needed).
Step 2. Create destination Marketo Connection.
Step 3. Create a Flow where the destination is a database.
Step 4. Add new source-to-destination transformation.
Step 5. Select FROM
and TO
Connections and objects (also a FROM
Format if needed).
Step 6. Optionally, define the per-field Mapping.
Step 7. Add more transformations, if needed.
Manage Marketo API quote
By default, Marketo allows 50K API calls per day, with a rate per instance limited to 100 calls per 20 seconds (https://developers.marketo.com/rest-api/
). Contact Marketo support to request a permanent or temporary increase.
Here are some tips on how to stay within the permitted limits:
- Avoid running
select * from
on any Marketo table. To return the count, the Marketo connector will have to traverse all the records in the table, which can easily cause exceeding the API quote (50K/day). - Avoid running transformations in parallel. Running transformations in parallel can cause exceeding the permitted rate of the API calls (100 calls per 20 seconds).
Browse data in Marketo
You must have a Marketo Connection to browse objects and run SQL queries.
Use the Etlworks Explorer to browse data and metadata in Marketo, as well as execute DML and SELECT
queries against Marketo Connection.
- Startup
- Business
- Enterprise
- On-Premise
- Add-on
Overview
Etlworks Marketo connector allows fast, real-time access to Marketo data. The connector supports most of the objects available through the Marketo API, and it works just like any other database connector.
Etlworks partnered with CData to provide access to the Marketo API using industry-standard JDBC protocol. Read about CData Marketo JDBC connector.
When to use Marketo connector
Use this connector to create Flows that work with data in Marketo.
Prerequisites
- Enable Marketo connector for your Etlworks Integrator account. Contact
support@etlworks.com
to enable connector. - Obtain the
OAuthClientId
andOAuthClientSecret
values. To do this, navigate to theLaunchPoint
option on the Admin area. Click theView Details
link for the desired service, and a window containing the authentication credentials will be displayed. - Obtain the REST Endpoint URL, which can be found on your Marketo Admin area, specifically on the
Integration
>Web Services
option in the REST API section. TheIdentity Endpoint
will not be needed.
Create a Connection
Follow the steps below in creating a Marketo Connection:
Step 1. In the Connections
window, click +
, and type in marketo
.
Step 2. Enter the following Connection parameters:
URL
: the JDBC Connection string. Typically, you only need to replace<instance>
with the Marketo instance name, for example,177-FXY-123
.Client ID
: the OAuth2 client ID.Client Secret
: the OAuth2 secret. Read about Marketo API client ID and client secret.Other Parameters
: optional parameters askey=value
pairs.
Use Other parameters
to specify the Connection string options. Read about available Connection string options.
Marketo data model
Read about the Marketo REST API data model, specifically, the filters required to retrieve data from some objects.
Stored procedures
Stored Procedures are available to complement the data available from the REST Data Model. Sometimes, it is necessary to update the data available from a view using a stored procedure because it does not provide direct, table-like, two-way updates. In these situations, the data retrieval is done using the appropriate view or table, while the update is done by calling a Stored Procedure. Stored Procedures take a list of parameters and return a dataset that contains the collection of tuples that constitute the response.
Read about available Stored Procedures.
To call stored procure from the SQL Flow or the Before/After SQL, use EXEC sp_name params=value
syntax.
For example:
EXEC SelectEntries ObjectName = 'Account'
Work with data in Marketo
Extract data from Marketo
Extracting data from Marketo is similar to extracting data from the relational database.
Here's a detailed instruction on how to extract data from Marketo:
Step 1. Create Marketo Connection that will be used as a source (FROM
).
Step 2. Create a destination Connection, for example, a Connection to the relational database, and if needed, a Format (Format is not needed if the destination is a database or well-known API).
Step 3. Create a Flow where the source is a database, and the destination is a Connection created in step 2, for example, a relational database.
Step 4. Add new source-to-destination transformation.
Step 5. Select the Marketo Connection created in step 1 as a source Connection, and select the Marketo object you are extracting data from.
Step 6. Select TO
Connection, Format (if needed), and object (for example database table) to load data into.
Step 7. Click MAPPING
and optionally enter Source query
(you don't need a query if you are extracting data from the Marketo object unconditionally).
Step 8. Optionally, define the per-field Mapping.
Step 9. Add more transformations, if needed.
Load data in Marketo
Loading data in Marketo is similar to loading data into a relational database.
Here's a step by step instruction on how to load data in Marketo:
Step 1. Create a source Connection and a Format (if needed).
Step 2. Create destination Marketo Connection.
Step 3. Create a Flow where the destination is a database.
Step 4. Add new source-to-destination transformation.
Step 5. Select FROM
and TO
Connections and objects (also a FROM
Format if needed).
Step 6. Optionally, define the per-field Mapping.
Step 7. Add more transformations, if needed.
Manage Marketo API quote
By default, Marketo allows 50K API calls per day, with a rate per instance limited to 100 calls per 20 seconds (https://developers.marketo.com/rest-api/
). Contact Marketo support to request a permanent or temporary increase.
Here are some tips on how to stay within the permitted limits:
- Avoid running
select * from
on any Marketo table. To return the count, the Marketo connector will have to traverse all the records in the table, which can easily cause exceeding the API quote (50K/day). - Avoid running transformations in parallel. Running transformations in parallel can cause exceeding the permitted rate of the API calls (100 calls per 20 seconds).
Browse data in Marketo
You must have a Marketo Connection to browse objects and run SQL queries.
Use the Etlworks Explorer to browse data and metadata in Marketo, as well as execute DML and SELECT
queries against Marketo Connection.
Comments
0 comments
Please sign in to leave a comment.