Get a SQL script
scripts_get_sql(id)
| id | integer required. |
|---|
A list containing the following elements:
integer, The ID for the script.
string, The name of the script.
string, The type of the script (e.g SQL, Container, Python, R, JavaScript)
string, The time this script was created.
string, The time the script was last updated.
list, A list containing the following elements:
id integer, The ID of this user.
name string, This user's name.
username string, This user's username.
initials string, This user's initials.
online boolean, Whether this user is online.
string, The status of the script's last run.
string, The time that the script's last run finished.
string, The category of the script.
array, An array containing the following fields:
id integer, The ID for the project.
name string, The name of the project.
integer, The ID of the parent job that will trigger this script
string, "runner" or "author", who to execute the script as when run as a template.
array, An array containing the following fields:
name string, The variable's name as used within your code.
label string, The label to present to users when asking them for the value.
description string, A short sentence or fragment describing this parameter to the end user.
type string, The type of parameter. Valid options: string, multi_line_string, integer, float, bool, file, table, database, credential_aws, credential_redshift, or credential_custom
required boolean, Whether this param is required.
value string, The value you would like to set this param to. Setting this value makes this parameter a fixed param.
default string, If an argument for this parameter is not defined, it will use this default value. Use true, True, t, y, yes, or 1 for true bool's or false, False, f, n, no, or 0 for false bool's. Cannot be used for parameters that are required or a credential type.
allowedValues array, The possible values this parameter can take, effectively making this an enumerable parameter. Allowed values is an array of hashes of the following format: `label: 'Import', 'value': 'import'`
list, Parameter-value pairs to use when running this script. Only settable if this script has defined parameters.
boolean, Whether others scripts use this one as a template.
integer, The ID of the template that this script is backing.
integer, The ID of the template this script uses, if any.
integer, How many other scripts use this one as a template.
string, The name of the template script.
list, A list containing the following elements:
details string, The details link to get more information about the script.
runs string, The runs link to get the run information list for this script.
list, A list containing the following elements:
scheduled boolean, If the item is scheduled.
scheduledDays array, Day based on numeric value starting at 0 for Sunday.
scheduledHours array, Hours of the day it is scheduled on.
scheduledMinutes array, Minutes of the day it is scheduled on.
scheduledRunsPerHour integer, Alternative to scheduled minutes, number of times to run per hour.
list, A list containing the following elements:
urls array, URLs to receive a POST request at job completion
successEmailSubject string, Custom subject line for success e-mail.
successEmailBody string, Custom body text for success e-mail, written in Markdown.
successEmailAddresses array, Addresses to notify by e-mail when the job completes successfully.
successEmailFromName string, Name from which success emails are sent; defaults to "Civis."
successEmailReplyTo string, Address for replies to success emails; defaults to the author of the job.
failureEmailAddresses array, Addresses to notify by e-mail when the job fails.
stallWarningMinutes integer, Stall warning emails will be sent after this amount of minutes.
successOn boolean, If success email notifications are on.
failureOn boolean, If failure email notifications are on.
list, A list containing the following elements:
id integer, The ID of this user.
name string, This user's name.
username string, This user's username.
initials string, This user's initials.
online boolean, Whether this user is online.
string, The time of the next scheduled run.
string, The time zone of this script.
list, A list containing the following elements:
id integer,
state string,
createdAt string, The time that the run was queued.
startedAt string, The time that the run started.
finishedAt string, The time that the run completed.
error string, The error message for this run, if present.
boolean, The hidden status of the item.
integer, Target project to which script outputs will be added.
string, The archival status of the requested item(s).
string, The raw SQL query for the script.
list, Expanded arguments for use in injecting into different environments.
integer, The remote host ID that this script will connect to.
integer, The credential that this script will use.
string, The code that this script will run with arguments inserted.
list, A list containing the following elements:
includeHeader boolean, Whether or not to include headers in the output data. Default: true
compression string, The type of compression to use, if any, one of "none", "zip", or "gzip". Default: gzip
columnDelimiter string, Which delimiter to use, one of "comma", "tab", or "pipe". Default: comma
unquoted boolean, Whether or not to quote fields. Default: false
forceMultifile boolean, Whether or not the csv should be split into multiple files. Default: false
filenamePrefix string, A user specified filename prefix for the output file to have. Default: null
maxFileSize integer, The max file size, in MB, created files will be. Only available when force_multifile is true.