Kinetica C# API  Version 6.2.0.1
kinetica.CreateProcRequest Class Reference

A set of parameters for Kinetica.createProc(string,string,IDictionary<string, byte[]>,string,IList<string>,IDictionary<string, string>). More...

+ Inheritance diagram for kinetica.CreateProcRequest:
+ Collaboration diagram for kinetica.CreateProcRequest:

Classes

struct  ExecutionMode
 The execution mode of the proc. More...
 
struct  Options
 Optional parameters. More...
 

Public Member Functions

 CreateProcRequest ()
 Constructs a CreateProcRequest object with default parameters. More...
 
 CreateProcRequest (string proc_name, string execution_mode=null, IDictionary< string, byte[]> files=null, string command=null, IList< string > args=null, IDictionary< string, string > options=null)
 Constructs a CreateProcRequest object with the specified parameters. More...
 
- Public Member Functions inherited from kinetica.KineticaData
 KineticaData (KineticaType type)
 Constructor from Kinetica Type More...
 
 KineticaData (System.Type type=null)
 Default constructor, with optional System.Type More...
 
object Get (int fieldPos)
 Retrieve a specific property from this object More...
 
void Put (int fieldPos, object fieldValue)
 Write a specific property to this object More...
 

Properties

string proc_name [get, set]
 Name of the proc to be created. More...
 
string execution_mode [get, set]
 The execution mode of the proc. More...
 
IDictionary< string, byte[]> files = ExecutionMode.DISTRIBUTED [get, set]
 A map of the files that make up the proc. More...
 
string command = new Dictionary<string, byte[]>() [get, set]
 The command (excluding arguments) that will be invoked when the proc is executed. More...
 
IList< string > args = "" [get, set]
 An array of command-line arguments that will be passed to when the proc is executed. More...
 
IDictionary< string, string > options = new List<string>() [get, set]
 Optional parameters. More...
 
- Properties inherited from kinetica.KineticaData
Schema Schema [get]
 Avro Schema for this class More...
 

Additional Inherited Members

- Static Public Member Functions inherited from kinetica.KineticaData
static RecordSchema SchemaFromType (System.Type t, KineticaType ktype=null)
 Create an Avro Schema from a System.Type and a KineticaType. More...
 

Detailed Description

A set of parameters for Kinetica.createProc(string,string,IDictionary<string, byte[]>,string,IList<string>,IDictionary<string, string>).


Creates an instance (proc) of the user-defined function (UDF) specified by the given command, options, and files, and makes it available for execution. For details on UDFs, see: User-Defined Functions

Definition at line 22 of file CreateProc.cs.

Constructor & Destructor Documentation

◆ CreateProcRequest() [1/2]

kinetica.CreateProcRequest.CreateProcRequest ( )
inline

Constructs a CreateProcRequest object with default parameters.

Definition at line 161 of file CreateProc.cs.

◆ CreateProcRequest() [2/2]

kinetica.CreateProcRequest.CreateProcRequest ( string  proc_name,
string  execution_mode = null,
IDictionary< string, byte[]>  files = null,
string  command = null,
IList< string >  args = null,
IDictionary< string, string >  options = null 
)
inline

Constructs a CreateProcRequest object with the specified parameters.

Parameters
proc_nameName of the proc to be created. Must not be the name of a currently existing proc.
execution_modeThe execution mode of the proc. Supported values:
  • DISTRIBUTED: Input table data will be divided into data segments that are distributed across all nodes in the cluster, and the proc command will be invoked once per data segment in parallel. Output table data from each invocation will be saved to the same node as the corresponding input data.
  • NONDISTRIBUTED: The proc command will be invoked only once per execution, and will not have access to any input or output table data.
The default value is DISTRIBUTED.
filesA map of the files that make up the proc. The keys of the map are file names, and the values are the binary contents of the files. The file names may include subdirectory names (e.g. 'subdir/file') but must not resolve to a directory above the root for the proc. The default value is an empty Dictionary.
commandThe command (excluding arguments) that will be invoked when the proc is executed. It will be invoked from the directory containing the proc and may be any command that can be resolved from that directory. It need not refer to a file actually in that directory; for example, it could be 'java' if the proc is a Java application; however, any necessary external programs must be preinstalled on every database node. If the command refers to a file in that directory, it must be preceded with './' as per Linux convention. If not specified, and exactly one file is provided in , that file will be invoked. The default value is ''.
argsAn array of command-line arguments that will be passed to when the proc is executed. The default value is an empty List.
optionsOptional parameters.
  • MAX_CONCURRENCY_PER_NODE: The maximum number of concurrent instances of the proc that will be executed per node. 0 allows unlimited concurrency. The default value is '0'.
The default value is an empty Dictionary.

Definition at line 225 of file CreateProc.cs.

Property Documentation

◆ args

IList<string> kinetica.CreateProcRequest.args = ""
getset

An array of command-line arguments that will be passed to when the proc is executed.

The default value is an empty List.

Definition at line 143 of file CreateProc.cs.

◆ command

string kinetica.CreateProcRequest.command = new Dictionary<string, byte[]>()
getset

The command (excluding arguments) that will be invoked when the proc is executed.

It will be invoked from the directory containing the proc and may be any command that can be resolved from that directory. It need not refer to a file actually in that directory; for example, it could be 'java' if the proc is a Java application; however, any necessary external programs must be preinstalled on every database node. If the command refers to a file in that directory, it must be preceded with './' as per Linux convention. If not specified, and exactly one file is provided in , that file will be invoked. The default value is ''.

Definition at line 138 of file CreateProc.cs.

◆ execution_mode

string kinetica.CreateProcRequest.execution_mode
getset

The execution mode of the proc.

Supported values:

  • DISTRIBUTED: Input table data will be divided into data segments that are distributed across all nodes in the cluster, and the proc command will be invoked once per data segment in parallel. Output table data from each invocation will be saved to the same node as the corresponding input data.
  • NONDISTRIBUTED: The proc command will be invoked only once per execution, and will not have access to any input or output table data.

The default value is DISTRIBUTED.

Definition at line 116 of file CreateProc.cs.

◆ files

IDictionary<string, byte[]> kinetica.CreateProcRequest.files = ExecutionMode.DISTRIBUTED
getset

A map of the files that make up the proc.

The keys of the map are file names, and the values are the binary contents of the files. The file names may include subdirectory names (e.g. 'subdir/file') but must not resolve to a directory above the root for the proc. The default value is an empty Dictionary.

Definition at line 124 of file CreateProc.cs.

◆ options

IDictionary<string, string> kinetica.CreateProcRequest.options = new List<string>()
getset

Optional parameters.

  • MAX_CONCURRENCY_PER_NODE: The maximum number of concurrent instances of the proc that will be executed per node. 0 allows unlimited concurrency. The default value is '0'.

The default value is an empty Dictionary.

Definition at line 156 of file CreateProc.cs.

◆ proc_name

string kinetica.CreateProcRequest.proc_name
getset

Name of the proc to be created.

Must not be the name of a currently existing proc.

Definition at line 91 of file CreateProc.cs.


The documentation for this class was generated from the following file: