Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Insert excerpt
_Banners
_Banners
nameanalysis
nopaneltrue

This page is for data modellers. It provides an introduction to tables and pipes.

Overview

In an analysis model,

a dataset is represented by a table. A table is a bit like an Excel spreadsheet, in that it contains a set of data with:columns

data is held in a table which consists of:

  • Columns - these are the attributes.
rows sends data from the input table to the output table
  • Rows - these are the data records.
In PhixFlow you connect two tables with a pipe. A pipe 

Tables can be connected with pipes, which are used to send data from one table to another. Pipes also connect other types of modelling

object

objects, such as a datasource that connects to a database or file exporter. Usually, a pipe has default settings

. This

, this means it passes all attributes and records onto the next object. However, you can use the pipe properties to control which attributes and records from the input object you want to pass through

.When you

.

For example, here we have data being imported from a database using a datasource and data collector, the data is held in its original form in a table before being passed onto a second table where is it enriched. It is possible to add filters on any of the pipes to remove records, such as a business being found with no name or a transaction being older than a specified date.


Image Added

To move data between modelling objects we must run an analysis model

,

PhixFlow then uses the information in each object's properties to process the data.

This means each table and pipe can transform the data in the analysis model. With

Because with each analysis run

,

the data in a table can change,

so

PhixFlow keeps

a  snapshot

the dataset for each run.

The snapshot is called a recordset

If there is a problem in the analysis run, you can delete

the new recordset by rolling back the run. PhixFlow reverts the data

a dataset(s) by reverting back to the selected

, previous

recordset; see Rollback RecordsetsYou can also copy or move data from a

recordset.To look at the data in a table, you use a view. The

dataset; see Copying or Moving Table Data.

Viewing Data in a Table is possible via views, the default view shows data in a grid. You can also create

different

your own views such as graphs and charts. View properties have lots of options to control which attributes are included in the view, which records are shown and how to sort the records.

Running Analysis

This topic includes:

Child pages (Children Display)

Panel
borderColor#7da054
titleColorwhite
titleBGColor#7da054
borderStylesolid
titleSections on this page

Table of Contents
indent12px
stylenone

Streams and Time Periods

In any given moment, a streams contains a set of records. This is the record-set. You can set the time period over which PhixFlow collects records

Running analysis is where PhixFlow evaluates your configuration and uses this information to processes your data. Analysis is started from a table, and then all modelling objects which procede the table will process the data in order. It should be noted that:

  • Not all modelling objects will appear or need to be in the same analysis model. This means running analysis can run analysis on more modelling objects than appear in your analysis model.
  • Some modelling objects can be set to static, these will not run, unless analysis is run directly on them and PhixFlow will not run any items which precede a static item. This is useful where there is information which you do not need to reprocess every time you run analysis, or want to run it on a different schedule.

Solution

  1. To Run Analysis, hover over the 
    Insert excerpt
    _tables
    _tables
    nopaneltrue
     and click 
    Insert excerpt
    _run_analysis
    _run_analysis
    nopaneltrue
    :
    1. Image Added
  2. To Run Analysis automatically on a timed schedule, see Task Plans.

Static Objects

There are several reasons you may wish to set a modelling object to be static, including:

  • You have information which does not need to be updated using an analysis model, such as country ISO codes or VAT amounts. These can be updated by a user through a screen.
  • You want data to be updated on a separate schedule from the other data.

Solution

  1. Tables
    1. Switch on static: hover over the item on an analysis model and click 
      Insert excerpt
      _static
      _static
      nopaneltrue
      .
    2. Switch off static:
      1. locate the table in the repository and double click it.
      2. In the properties window that opens locate the Analysis Options section and expand it.
      3. Untick Static.
  2. Pipes
    1. Switch on Static: Hover over the pipe and click 
      Insert excerpt
      _static
      _static
      nopaneltrue
      .
    2. Switch off static: Hover over the pipe and click the play button.

Tables and Time Periods

A table can contain any number of datasets, each in turn can contain many records. Depending on how the data will be interacted with, you will need to set the time period which PhixFlow uses to collect the datasets. The period can be:

Insert excerpt
Table

Properties

Table

Properties

namePeriod
nopaneltrue

For non-transactional periods, PhixFlow checks for incomplete record-sets and reports an error if it finds them. However, pipes from transactional

streams

tables allow incomplete

record-sets

recordsets, as data is constantly changing.

Pipes and Data to Read

Pipes have a plethora of uses (see Pipe), one key use is selecting which dataset(s) to read. The two most common options are:

  1. All: This means that the pipe will pull the data from all datasets.
  2. Latest: This means the pipe will only pull information from the very latest dataset.

This option is available in the pipe properties → Data to Read. 

Publishing

Streams

Tables
Anchor
publish
publish

When you make changes to a

stream

table's properties or its attributes, PhixFlow publishes the changes to the PhixFlow database. This happens automatically in the background. Publishing many

streams

tables or

streams

tables with many attributes can take some time

, and may slow performance

.

If

the stream

the table properties are set incorrectly, PhixFlow will not be able to publish

the stream

the table to the database. If this happens, the

Insert excerpt
_console
_console
nopaneltrue
 will report the publishing error. PhixFlow will also display an error message if you try to interact with the

stream

table, for example to view its data or to run analysis. You must correct

the stream

the table properties, so that PhixFlow can retry publishing the

stream

table

During the publishing process, PhixFlow may create

temporary streams

temporary tables in its database. These are kept for a period, then automatically removed when a system task runs. For information about:

temporary streams
Streams
  • Tables after Days.

Insert excerpt
_publishing_space
_publishing_space
nopaneltrue

Learn More

Properties Properties Properties PropertiesRolling-back recordsets
  • Rollback Window
  • Rollback or Repeat Cycles Window

    Some options may still refer to streams and stream sets.

    Insert excerpt
    _terms_changing
    _terms_changing
    nopaneltrue