# Safe Mode

The *Safe Mode* option in Astera allows you to study and debug your dataflows in cases when access to source files or databases is not available. You can open a dataflow/subflow and then proceed to debug or understand it after activating *Safe Mode*.

In this article, we will be looking at how you can activate and use the *Safe Mode* option in Astera.

### Activating Safe Mode

To activate *Safe Mode*, press the *Safe Mode* icon placed in the toolbar at the top of the dataflow designer.

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2Fs80qpqQvnCeQ5b3PNPpX%2F01-SafeMode-Icon.png?alt=media\&token=78444744-fb16-440b-a631-a9b1eadfbf9f)

Once *Safe Mode* is activated, the icon will have an outlining box around it.

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2FHIWSWTGcQ4z8rDGuS3X6%2F02-SafeMode-Icon-Active.png?alt=media\&token=d79e06bd-f7d4-45d4-8ec2-4a833b12eccc)

### Use Case

Here, we have a sample dataflow that was created by another Astera user.

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2F0IEmMuOWn8cd9bDvK2li%2F03-Use-Case.png?alt=media\&token=b3e02231-964c-4006-addf-85ac9bd72806)

This dataflow contains a *Database Table Source*, as assigned by the previous user. In this use case, we will be using the *Safe Mode* option to access the properties of the *Database Table Source* object named *Invoices*, in order to understand the layout of the data and other conditions.

#### When Safe Mode is Inactive

As the dataflow is not our own, we do not have access to the source database tables and cannot see the data’s layout ourselves.

To access the *Properties* for the *Database Table Source* object, right-click on its header and select *Properties* from the context menu.

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2FtcdW4yeqm8HV47B8IXDs%2F04-Accessing-Properties.png?alt=media\&token=f80a0cfc-3c71-4b28-9fc2-6462610567c0)

Click *Next* on the bottom of the *Database Connection* screen of the configuration window to access the *Pick Source Table and Reading Option* section.

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2FZBhV1hr1VI28t5DYbcA5%2F05-DB-Properties.png?alt=media\&token=52719c10-3e87-43fe-b036-076dc2365e5a)

When trying to access the *Pick Source Table and Reading Option* and further sections, we come across an error and it does not let us proceed, bringing us to a halt in the process.

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2FqNYI7x2LbtJeP0SEH2e8%2F06-Error-1652266863248.png?alt=media\&token=3597d9e6-cdef-4385-aeb4-46fce11336d0)

This error is expected as we do not have access to the source database being used.

Press *OK* and then *Cancel* to exit the configuration window.

#### When Safe Mode is Active

In order to proceed, we will now activate *Safe Mode*.

1\. Once *Safe Mode* is activated, proceed to access the *Properties* and then the *Pick Source Table and Reading Option* section of the configuration window for the *Database Table Source* object.

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2FPAbWmaFs7Jd618xIoALz%2F05-DB-Properties.png?alt=media\&token=5551fd25-de87-41a1-b053-8b589c2ae485)

2\. This time, with *Safe Mode* activated, Astera allows us to proceed to the *Pick Source Table and Reading Option* screen. Here, we can see all the options utilized by the previous user to read a specific database table.

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2FS84JYHo1AVjSHrngbIGT%2F08-Pick-Source-Table.png?alt=media\&token=d0eb67eb-9069-450a-828b-95e88fa7764b)

3\. Press *Next* again on the *Pick Source Table and Reading Option* screen to proceed to the *Layout Builder* screen, which shows the fields, their data types and other properties.

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2FqULL7ARpY8SKkDsRrihM%2F09-Layout-Builder.png?alt=media\&token=220cd670-618e-42b7-90cd-ffb5b0ed3a6e)

4\. Press *Next* on this section to proceed to the *Where Clause* screen in order to understand the clause used, if any, by the previous user.

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2F2gVBt9yc95oWXZGk0o7W%2F10-Where-Clause.png?alt=media\&token=9bec50b8-368a-49d6-9bda-174f51d26400)

Here, we can see that a where clause has been used to identify records which specifically cater to the *Country* field being ‘France’.

5\. Press *Next* to proceed to the *Config Parameters* screen to see if any parameters have been set.

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2Fvc9IrYCWLnpuf4fnU9SU%2F11-Config-Params.png?alt=media\&token=41e06c33-7a4f-4a90-96ac-a05621e70113)

6\. Lastly, press *OK* to close the properties window for the *Database Table Source* object.

To learn more about the *Database Table Source* object, click [here](https://documentation.astera.com/astera-data-stack-v10/dataflows/sources/database-table-source).

You can now configure the object as required and/or load your own database tables.

*Safe Mode* can be used to access properties for any object that has been configured with source files/tables/queries etc. that a user does not have access to, thus facilitating debugging and dataflow sharing.

This concludes our discussion on the *Safe Mode* option.

<br>
