Reference

Reference section for Oracle Cloud Infrastructure Data Flow including a Glossary of terms and links to REST API documentation.

Glossary

Concept Glossary

Apache Spark: Apache Spark is a unified analytics engine for big data processing, with built-in modules for streaming, SQL, machine learning and graph processing.

Spark Application: Spark Applications are applications that use the Spark API to perform distributed data processing tasks. Spark Applications can be written in several languages including Java, Python and more. Spark Applications are files such as JAR files that are run within the Spark framework.

Data Flow Application: Data Flow Applications are templates that bundle together a Spark Application and specify a Spark version, default resource sizing and default application parameters.

Data Flow Run: Data Flow Applications can be run many times. Each of these results in a Data Flow Run object. Resource sizes and parameters can be optionally overridden at run time by the user. A Data Flow Run tracks information relevant to the Application's execution, such as statistics and logs.

Spark UI: The Spark UI is included with Apache Spark and is an important tool for debugging and diagnosing Spark applications. You can access the Spark UI for any Data Flow Run, subject to the Run's authorization policies.

Spark Logs: Spark generates log files which are useful for debugging and diagnostics. Each Data Flow Run automatically stores log files which you can access through the Spark UI or API, subject to the Run's authorization policies.

REST API

Find out how to use REST API with Data Flow.

Learn how to implement REST API with Data Flow in the REST API documentation.

Free-form resource requests aren't supported when using Livy API.

The implementation accepts two new parameters:
  • driverShape
  • executorShape
If one or both is missing a warning is logged. If an invalid shape is passed, the resultant error lists the supported shapes. There is a shapes endpoint that returns the valid shapes with their sizes/types.

IP Address Allowlist

If you read or write data using Data Flow without using private networking solutions such as VCN, you need to allowlist certain IP addresses where Data Flow runs. This is the list of IP addresses that you can allowlist:

Allowlist IP Addresses
Region NameRegion IdentifierData Flow Source IP Address
Australia East (Sydney)ap-sydney-1152.67.104.210
Australia Southeast (Melbourne)ap-melbourne-1168.138.1.225
Brazil East (Sao Paulo)sa-saopaulo-1152.67.56.151
Brazil Southeast (Vinhedo) sa-vinhedo-1 193.123.107.188
Canada Southeast (Montreal)ca-montreal-1168.138.66.144
Canada Southeast (Toronto)ca-toronto-1132.145.105.28
Chile (Santiago) sa-santiago-1 129.151.97.194
France Central (Paris)eu-paris-1141.145.193.217
France South (Marseille) eu-marseille-1 129.151.241.124
Germany Central (Frankfurt)eu-frankfurt-1132.145.248.79
India South (Hyderabad) ap-hyderabad-1 152.67.176.234
India West (Mumbai)ap-mumbai-1140.238.164.243
Israel 1 (Jerusalem) il-jerusalem-1 129.159.145.227
Italy Northwest (Milan) eu-milan-1 129.152.14.225
Japan Central (Osaka)ap-osaka-1168.138.39.160
Japan East (Tokyo)ap-tokyo-1140.238.44.156
Mexico Central (Queretaro)mx-queretaro-1140.84.176.156
Mexico North East (Monterrey)mx-monterrey-1139.177.97.38
Netherlands Northwest (Amsterdam)eu-amsterdam-1158.101.193.70
Saudi Arabia West (Jeddah)me-jeddah-1158.101.226.105
Singapore (Singapore) ap-singapore-1 168.138.176.223
South Africa Central (Johannesburg) af-johannesburg-1 129.151.160.154
South Korea Central (Seoul)ap-seoul-1132.145.87.75
South Korea North (Chuncheon) ap-chuncheon-1 150.136.195.44
Sweden (Stockholm) eu-stockholm-1 129.151.213.127
Switzerland North (Zurich)eu-zurich-1152.67.68.12
Sweden (Stockholm) eu-stockholm-1 129.151.213.127
Spain Central (Madrid)eu-madrid-1143.47.59.31
UAE Central (Abu Dhabi) me-abudhabi-1 129.151.143.178
UAE East (Dubai) me-dubai-1193.123.69.152
UK South (London)uk-london-1132.145.13.171
UK West (Newport) uk-cardiff-1 129.151.75.8
US East (Ashburn)us-ashburn-1150.136.195.44
US Midwest (Chicago)us-chicago-1131.186.3.94
US West (Phoenix)us-phoenix-1129.146.95.238
US West (San Jose) us-sanjose-1 152.67.227.225