{"objects":[{"metadata":{"identifier":{"packageName":"Matillion Exchange","name":"Facebook AdAccounts Incremental Load","revision":2,"type":"DYNAMIC"},"rootJobReference":{"name":"Facebook AdAccounts - 1 - Orchestrator","type":"ORCHESTRATION","parameterMetadata":[{"slot":2,"variableName":"oauth","variableType":"SCALAR","displayName":"OAuth","description":"The name of the OAuth entry to be used from the Matillion OAuth Manager to connect to the source. These must be set up in advance, using Project → Manage OAuth.","defaultValue":[{"values":{"1":""}}],"defaultValueType":"TEXT","required":true},{"slot":3,"variableName":"key_value","variableType":"SCALAR","displayName":"Account value","description":"This is the Account value to be processed and will have format of 'act_xxxxxxxxxxxxx'.","defaultValue":[{"values":{"1":""}}],"defaultValueType":"TEXT","required":true},{"slot":4,"variableName":"advanced_connection_options","variableType":"GRID","displayName":"Connection Options","description":"A list of values and parameters. Parameters and their allowed values are database/driver specific. Referring to the data model will provide insight of what you could provide here.\n
\nThey are usually not required as sensible defaults are assumed.","defaultValue":[{"values":{"1":""}}],"defaultValueType":null,"required":true},{"slot":5,"variableName":"source_list","variableType":"GRID","displayName":"Tables and Columns","description":"Contains the list of tables and columns (and in some cases an incremental_column to specify which column the load should be incremented on [accepts values of 0 or 1]) to be processed. ","defaultValue":[{"values":{"1":""}}],"defaultValueType":null,"required":true},{"slot":6,"variableName":"load_concurrent","variableType":"SCALAR","displayName":"Load Type","description":"Sequential - Iterations are done in sequence, waiting for each to complete before starting the next. \nThis is the default.\n
\nConcurrent - Iterations are run concurrently. This requires all \"Variables to Iterate\" to be defined as\nCopied variables, so that each iteration gets its own copy of the variable isolated from the same\nvariable being used by other concurrent executions.\n
Note: The maximum concurrency is limited by the number of available threads (2x the number of virtual cpus on your cloud instance).","defaultValue":[{"values":{"1":"Sequential"}}],"defaultValueType":"TEXT","required":true},{"slot":7,"variableName":"stage_prefix","variableType":"SCALAR","displayName":"Stage Prefix","description":"A prefix value that will be added to the start of the stage table names.\n
\ne.g. If a Stage Prefix of 'stage_' is specified and the table being processed is named 'test_data' then the target table will be named 'stage_test_data'.","defaultValue":[{"values":{"1":""}}],"defaultValueType":"TEXT","required":true},{"slot":8,"variableName":"stage_database","variableType":"SCALAR","displayName":"Stage Database","description":"The database name where the staging data will be stored.","defaultValue":[{"values":{"1":""}}],"defaultValueType":"TEXT","required":true},{"slot":9,"variableName":"stage_schema","variableType":"SCALAR","displayName":"Stage Schema","description":"The schema name where the staging data will be stored.","defaultValue":[{"values":{"1":""}}],"defaultValueType":"TEXT","required":true},{"slot":10,"variableName":"stage_warehouse","variableType":"SCALAR","displayName":"Stage Warehouse","description":"The warehouse name where the staging data will be stored.","defaultValue":[{"values":{"1":""}}],"defaultValueType":"TEXT","required":true},{"slot":11,"variableName":"target_prefix","variableType":"SCALAR","displayName":"Target Prefix","description":"A prefix value that will be added to the start of the target table names.\n
\ne.g. If a Target Prefix of 'target_' is specified and the table being processed is named 'test_data' then the target table will be named 'target_test_data'.","defaultValue":[{"values":{"1":""}}],"defaultValueType":"TEXT","required":true},{"slot":12,"variableName":"target_database","variableType":"SCALAR","displayName":"Target Database","description":"The database name where the target data will be stored.","defaultValue":[{"values":{"1":""}}],"defaultValueType":"TEXT","required":true},{"slot":13,"variableName":"target_schema","variableType":"SCALAR","displayName":"Target Schema","description":"The schema name where the target data will be stored.","defaultValue":[{"values":{"1":""}}],"defaultValueType":"TEXT","required":true},{"slot":14,"variableName":"target_warehouse","variableType":"SCALAR","displayName":"Target Warehouse","description":"The warehouse name where the target data will be stored.","defaultValue":[{"values":{"1":""}}],"defaultValueType":"TEXT","required":true},{"slot":15,"variableName":"encryption_method","variableType":"SCALAR","displayName":"Encryption","description":"(AWS Only) Decide on how the files are encrypted inside the S3 Bucket.This property is available when using an Existing Amazon S3 Location for Staging.
\n None: No encryption.
\n SSE KMS: Encrypt the data according to a key stored on KMS.
\n SSE S3: Encrypt the data according to a key stored on an S3 bucket","defaultValue":[{"values":{"1":"None"}}],"defaultValueType":"TEXT","required":false},{"slot":16,"variableName":"kms_key_id","variableType":"SCALAR","displayName":"KMS Key Id","description":"The ID of the KMS encryption key you have chosen to use in the 'Encryption' property.","defaultValue":[{"values":{"1":""}}],"defaultValueType":"TEXT","required":false},{"slot":17,"variableName":"staging_type","variableType":"SCALAR","displayName":"Staging","description":"Snowflake Managed: Allow Matillion ETL to create and use a temporary internal stage on Snowflake for staging the data. This stage, along with the staged data, will cease to exist after loading is complete.
\n Existing Amazon S3 Location: Selecting this will avail the user of properties to specify a custom staging area on S3.\n Existing Azure Blob Storage Location: Selecting this will avail the user of properties to specify a custom staging area on Azure.","defaultValue":[{"values":{"1":"Snowflake Managed"}}],"defaultValueType":"TEXT","required":false},{"slot":18,"variableName":"storage_account","variableType":"SCALAR","displayName":"Azure Storage Account","description":"(Azure Only) Azure Storage Account to allow Matillion ETL to specify a blob container object on Snowflake for staging data. ","defaultValue":[{"values":{"1":""}}],"defaultValueType":"TEXT","required":false},{"slot":19,"variableName":"blob_container","variableType":"SCALAR","displayName":"Azure Blob Container","description":"(Azure Only) Azure Blob Container to allow Matillion ETL to use the blob storage container object on Snowflake for staging data. ","defaultValue":[{"values":{"1":""}}],"defaultValueType":"TEXT","required":false},{"slot":20,"variableName":"s3_bucket_name","variableType":"SCALAR","displayName":"S3 Bucket Name","description":"(AWS Only) The name of an S3 bucket for temporary storage. Ensure your access credentials have S3 access and permission to write to the bucket. See this document for details on setting up access. The temporary objects created in this bucket will be removed again after the load completes, they are not kept.
\nThis property is available when using an Existing Amazon S3 Location for Staging.","defaultValue":[{"values":{"1":""}}],"defaultValueType":"TEXT","required":false},{"slot":21,"variableName":"log_metrics","variableType":"SCALAR","displayName":"Log Metrics","description":"Option to switch off Metrics logging in the full product - default is TRUE which records the metrics for the batch run. ","defaultValue":[{"values":{"1":"TRUE"}}],"defaultValueType":"TEXT","required":false}]},"orchestrationJobs":["Facebook AdAccounts - 1 - Orchestrator","Facebook AdAccounts - 2 - Wrapper","Facebook AdAccounts - 4 - Query Source","Facebook AdAccounts - 3 - Stage Object"],"transformationJobs":[],"imageMetadata":{"componentIcon":"iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAACp0lEQVR42u2X709SYRTH/R9qvevf6IVh6lparjlbWwkIcYVAhSD1zsv1qkGgKVCGCHpB1xYua7ZcxQvKtKLZrxe0cra12QtTWnPrRf0Dp/M8dplMbrXpvfiis30H9+Hhns895zzPPU9Z2X/bYoeMo/sON4q6cl3cpITIvYkPeedacR0FCmu9KAShU8H5ptDXNoBy7TijFgBJx44BqowTMJJ8CW8/rMHK6nf4/GVT53tn1QFYzK5CMXP2p5QHMHTNgJypAsBffVTgNLucg9DkCwiiGuxTygMIw48LAAYTz9Utwm0AcZUAzMI9+LiyAWvffhQAfN34SceJjNyMcgBOfwr+Zo3tt0sLUGO+oRxAfWsSfLEFuJteKnA6O7dM64JozxVhhW68dADVTTFovtBfGgDi3MX2wUXUyebrUKkfUxfgrC0IPM+Dm+8Gt7sbOJS+bRA0mBLVUtCEDu0dHloHpyzXgOUEMDv9ygIwjgE4aojmrxvQsfS99lyERqOlw2tTBIDknYT9uGlEfjfFCOCcO4oA1DFhCqApsvTytdESIHOyOwKw4DshnfmUl+PyAzpegyEmACQScv8ldYFzFmQBNDoRKg0J/IzTbbVCH4cjqH8B06A6u3pAi08pjZHltzUiVpcPOI7vkQVw+B7SxsITmYe+8BMa7t7wHA0zF0pTDYjPwIq9X2AiA57ReYjeeg1DiQxUY5942hqiS67ePEwdnsB6sGDeJQgCdMwQNcm25V68YfjmIu1wXNheEcfByQxEpl6BP/aUgo1Nv6EQ06n3FI5AJO+/g9rfLyJd6xBNRVu7Vyq6AoiibXmVVtyPP+Z2q/UmS85ovwIO3AcIgLPzkrQb5mRPRxSCHM0wHbulM7aADwGW6pgI88ejmVImCMJBlmUP7NkD8S8ltiFcO0H/7QAAAABJRU5ErkJggg==","smallIcon":"iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAABSklEQVR42mNgoAawjZjhbBU+Y711xIwNxGCQWpAeuAFQzf9JwSA9cAOgJmMoWrbl4v9Xb7/8f//x+//gnKXo8hvwGhCcu/Q/CHz++vP/0XMP//tlLCLNgOiSlWADjpx9gMsbuA0IylkCdjYI/Pr99//rd1//e6ctJN4A3/SF/09ffgI24PX7r//3HL/73y56FmleiMHiBdvIGf9d4yaTb0BCduv/rMKG/8GpPaQb4BY36b9L7JT/vkn9/4NSev+n5TVtItoAx+hp/+Oy2lDkMwvr76EYYBs1ExxQIBpsY+K8/1W9O/+n167/bxc1/X9iTgs8HMAGFDScR0nKzVP3/a+ftOd/87R9/9tmHADi/f87Zh383zp9//+85s3/I9I7/0dndvxPym0Bemfyf/sopKRMbGbyTuzfkF9Sey0otRc1M5ECysrKeJH5AHx2yVwJs7jbAAAAAElFTkSuQmCC"},"description":"","helpHtml":"
Property | Type | Description |
---|---|---|
OAuth | Variable | The name of the OAuth entry to be used from the Matillion OAuth Manager to connect to the source. These must be set up in advance, using Project → Manage OAuth. |
Account value | Variable | This is the Account value to be processed and will have format of 'act_xxxxxxxxxxxxx'. |
Connection Options | Grid | A list of values and parameters. Parameters and their allowed values are database/driver specific. Referring to the data model will provide insight of what you could provide here.\n \nThey are usually not required as sensible defaults are assumed. |
Tables and Columns | Grid | Contains the list of tables and columns (and in some cases an incremental_column to specify which column the load should be incremented on [accepts values of 0 or 1]) to be processed. |
Load Type | Variable | Sequential - Iterations are done in sequence, waiting for each to complete before starting the next. \nThis is the default.\n \nConcurrent - Iterations are run concurrently. This requires all "Variables to Iterate" to be defined as\n<a href="https://redshiftsupport.matillion.com/customer/portal/articles/2037630?b_id=8915#header1" target="_blank">Copied variables</a>, so that each iteration gets its own copy of the variable isolated from the same\nvariable being used by other concurrent executions.\n<span class="env rs sf"> Note: The maximum concurrency is limited by the number of available threads (2x the number of virtual cpus on your cloud instance). |
Stage Prefix | Variable | A prefix value that will be added to the start of the stage table names.\n \ne.g. If a Stage Prefix of 'stage_' is specified and the table being processed is named 'test_data' then the target table will be named 'stage_test_data'. |
Stage Database | Variable | The database name where the staging data will be stored. |
Stage Schema | Variable | The schema name where the staging data will be stored. |
Stage Warehouse | Variable | The warehouse name where the staging data will be stored. |
Target Prefix | Variable | A prefix value that will be added to the start of the target table names.\n \ne.g. If a Target Prefix of 'target_' is specified and the table being processed is named 'test_data' then the target table will be named 'target_test_data'. |
Target Database | Variable | The database name where the target data will be stored. |
Target Schema | Variable | The schema name where the target data will be stored. |
Target Warehouse | Variable | The warehouse name where the target data will be stored. |
Encryption | Variable | <span class="env sf">(AWS Only) Decide on how the files are encrypted inside the S3 Bucket.<span class="env sf">This property is available when using an Existing Amazon S3 Location for Staging. \n None: No encryption. \n SSE KMS: Encrypt the data according to a key stored on <a href="https://aws.amazon.com/kms/" target="_blank">KMS</a>. \n SSE S3: Encrypt the data according to a key stored on an <a href="http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html" target="_blank">S3 bucket</a> |
KMS Key Id | Variable | The ID of the KMS encryption key you have chosen to use in the 'Encryption' property. |
Staging | Variable | Snowflake Managed: Allow Matillion ETL to create and use a temporary internal stage on Snowflake for staging the data. This stage, along with the staged data, will cease to exist after loading is complete. \n Existing Amazon S3 Location: Selecting this will avail the user of properties to specify a custom staging area on S3.\n Existing Azure Blob Storage Location: Selecting this will avail the user of properties to specify a custom staging area on Azure. |
Azure Storage Account | Variable | (Azure Only) Azure Storage Account to allow Matillion ETL to specify a blob container object on Snowflake for staging data. |
Azure Blob Container | Variable | (Azure Only) Azure Blob Container to allow Matillion ETL to use the blob storage container object on Snowflake for staging data. |
S3 Bucket Name | Variable | <span class="env sf">(AWS Only) The name of an S3 bucket for temporary storage. Ensure your access credentials have S3 access and permission to write to the bucket. See <a href="https://redshiftsupport.matillion.com/customer/portal/articles/2054760" target="_blank">this document</a> for details on setting up access. The temporary objects created in this bucket will be removed again after the load completes, they are not kept. \n<span class="env sf">This property is available when using an Existing Amazon S3 Location for Staging. |
Log Metrics | Variable | Option to switch off Metrics logging in the full product - default is TRUE which records the metrics for the batch run. |