Kinetica C# API  Version 7.1.10.0
 All Classes Namespaces Files Functions Variables Enumerations Enumerator Properties Pages
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 functions (UDF) specified by the given command, options, and files, and makes it available for execution.

Definition at line 23 of file CreateProc.cs.

Constructor & Destructor Documentation

kinetica.CreateProcRequest.CreateProcRequest ( )
inline

Constructs a CreateProcRequest object with default parameters.

Definition at line 211 of file CreateProc.cs.

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 direct access to any tables named as input or output table parameters in the call to /execute/proc. It will, however, be able to access the database using native API calls.
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. Files may be loaded from existing files in KiFS. Those file names should be prefixed with the uri kifs:// and the values in the map should be empty. 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'.
  • SET_ENVIRONMENT: A python environment to use when executing the proc. Must be an existing environment, else an error will be returned. The default value is ''.
The default value is an empty Dictionary.

Definition at line 298 of file CreateProc.cs.

Property Documentation

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 186 of file CreateProc.cs.

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 181 of file CreateProc.cs.

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 direct access to any tables named as input or output table parameters in the call to /execute/proc. It will, however, be able to access the database using native API calls.

The default value is DISTRIBUTED.

Definition at line 149 of file CreateProc.cs.

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.
Files may be loaded from existing files in KiFS. Those file names should be prefixed with the uri kifs:// and the values in the map should be empty. The default value is an empty Dictionary.

Definition at line 162 of file CreateProc.cs.

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'.
  • SET_ENVIRONMENT: A python environment to use when executing the proc. Must be an existing environment, else an error will be returned. The default value is ''.

The default value is an empty Dictionary.

Definition at line 206 of file CreateProc.cs.

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 118 of file CreateProc.cs.


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