Versions Compared

Key

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

Applies to: (tick) Kyvos Enterprise  (tick) Kyvos Cloud (SaaS on AWS) (tick) Kyvos AWS Marketplace

...

You can create a dataset for use with Kyvos. When you create a dataset, choose the connection from which the data needs to be fetched. As you apply settings to sort and filter the columns, you can preview the results to make sure you get the results you are seeking.

...

  • From Kyvos 2024.11 onwards, when you modify any column after selecting the input type, it is you can now view a column marked as "Modified." " when changes are made to it in a dataset. Additionally, you can view the details of the changes madethose changes. This feature helps users quickly identify modified columns and review their specifics.

  • You can mark a file as a Fact to use it as a fact table in relationships. And you can hide columns not required for analysis. 

  • Use the Actions menu (...) to validate the dataset, share it, add a note, or show related entities.

  • If your instance of Kyvos has been configured via the portal.properties file to support it, you can register a file with a Presto connection. You can format columns and preview the result.

  • To register a file with a Presto connection, see Creating a file with a Presto connection. You can also create register files by  Writing SQL queries using data in Hive

  • To learn more about the effects of some of the settings you can use while registering the file, see Logic for creating relationships and semantic model.

To create a file, perform the following steps. 

  1. From the Toolbox, click Datasets.

  2. Click the Actions menu (  ) and click Add Dataset.

  3. Select the Connection from the list.

  4. Select any one of the following input types: 

    • HDFS

    • Table

    • SQL

Aura tab collection
paramsJTdCJTIyZ2VuZXJhbCUyMiUzQSU3QiUyMnRhYlNwYWNpbmclMjIlM0EwJTJDJTIydGFiV2lkdGglMjIlM0ExMDAlMkMlMjJ0YWJIZWlnaHQlMjIlM0E1MCUyQyUyMmRpcmVjdGlvbiUyMiUzQSUyMmhvcml6b250YWwlMjIlN0QlMkMlMjJjb250ZW50JTIyJTNBJTdCJTIyYmFja2dyb3VuZENvbG9yJTIyJTNBJTdCJTIyY29sb3IlMjIlM0ElMjIlMjNmZmYlMjIlN0QlMkMlMjJib3JkZXIlMjIlM0ElN0IlMjJzdHlsZSUyMiUzQSUyMnNvbGlkJTIyJTJDJTIyd2lkdGglMjIlM0ExJTJDJTIydG9wJTIyJTNBdHJ1ZSUyQyUyMmJvdHRvbSUyMiUzQXRydWUlMkMlMjJsZWZ0JTIyJTNBdHJ1ZSUyQyUyMnJpZ2h0JTIyJTNBdHJ1ZSUyQyUyMmNvbG9yJTIyJTNBJTdCJTIybGlnaHQlMjIlM0ElMjIlMjNjY2NlY2YlMjIlN0QlN0QlMkMlMjJwYWRkaW5nJTIyJTNBJTdCJTIydG9wJTIyJTNBMTAlMkMlMjJyaWdodCUyMiUzQTEwJTJDJTIyYm90dG9tJTIyJTNBMTAlMkMlMjJsZWZ0JTIyJTNBMTAlN0QlN0QlMkMlMjJhY3RpdmUlMjIlM0ElN0IlMjJiYWNrZ3JvdW5kQ29sb3IlMjIlM0ElN0IlMjJjb2xvciUyMiUzQSU3QiUyMmxpZ2h0JTIyJTNBJTIyJTIzZjU4MjI3JTIyJTdEJTdEJTJDJTIydGV4dCUyMiUzQSU3QiUyMmZvbnRTaXplJTIyJTNBMTYlMkMlMjJjb2xvciUyMiUzQSU3QiUyMmxpZ2h0JTIyJTNBJTIyJTIzMDAwMDAwJTIyJTdEJTJDJTIydGV4dEFsaWduJTIyJTNBJTIybGVmdCUyMiUyQyUyMmZvbnRXZWlnaHQlMjIlM0ElMjJib2xkJTIyJTdEJTdEJTJDJTIyaG92ZXIlMjIlM0ElN0IlMjJiYWNrZ3JvdW5kQ29sb3IlMjIlM0ElN0IlMjJjb2xvciUyMiUzQSUyMiUyM2RmZTFlNiUyMiU3RCUyQyUyMnRleHQlMjIlM0ElN0IlMjJmb250U2l6ZSUyMiUzQTE4JTJDJTIyY29sb3IlMjIlM0ElMjIlMjM1ZTZjODQlMjIlMkMlMjJ0ZXh0QWxpZ24lMjIlM0ElMjJsZWZ0JTIyJTJDJTIyZm9udFdlaWdodCUyMiUzQSUyMmxpZ2h0ZXIlMjIlN0QlN0QlMkMlMjJpbmFjdGl2ZSUyMiUzQSU3QiUyMmJhY2tncm91bmRDb2xvciUyMiUzQSU3QiUyMmNvbG9yJTIyJTNBJTIyJTIzZjRmNWY3JTIyJTdEJTJDJTIydGV4dCUyMiUzQSU3QiUyMmZvbnRTaXplJTIyJTNBMTYlMkMlMjJjb2xvciUyMiUzQSUyMiUyMzVlNmM4NCUyMiUyQyUyMnRleHRBbGlnbiUyMiUzQSUyMmxlZnQlMjIlMkMlMjJmb250V2VpZ2h0JTIyJTNBJTIybGlnaHRlciUyMiU3RCU3RCU3RA==
Aura tab
summaryHDFS
paramsJTdCJTIydGl0bGUlMjIlM0ElMjJIREZTJTIyJTdE
  1. From the Toolbox, click Files.

  2. Click the Actions menu (  ), choose Add File.

  3. Select the Connection from the list.

  4. Select the Input Type: HDFS. 

  5. Select the file. Click the ... to navigate to the file.

  6. Specify the File Type such as Character Separated Values, Parquet, or Sequence.

    image-20241126-064312.png
  7. Click the File Properties link to specify properties.

    1. Provide the line separator, field separator, escape characters, enclosed by, skip top lines, and encoding type options according to your file type.
      See the Registered file settings table section for details.

    2. For Compression, select None or LZO.

    3. If the data includes header information, select Contains Header Row so that the column headings will not be included as part of the data.

    4. Select Ignore Empty Rows to have empty rows ignored.

    5. Select Key as Column to set the field name to be the column description or select Filename as column to set the file name to the column description.

  8. Click Apply.

  9. To use this file for lookup purposes, select the Lookup file checkbox. See Using lookup to learn more.

  10. Click Refresh to view the columns on the right.

  11. Specify whether the file is a Dimension or Fact.

  12. If the source data contains primary key or foreign key, the system automatically marks it.

  13. When you choose to view the Column List, you can sort, filter, and set Column Properties as needed. See the rest of this topic to learn more.

  14. Choose Preview Table to see sample data and set up a filter. See the rest of this topic to learn more.

  15. Click Save when you are finished. You can click Revert if needed.

Aura tab
summaryTable
paramsJTdCJTIydGl0bGUlMjIlM0ElMjJUYWJsZSUyMiU3RA==
  1. From the Toolbox, click Files.

  2. Click the Actions menu ( ⋮ ), choose Add File.

  3. Select the Connection from the list.

  4. Select the Input type: Table. 

  5. Select the Table database followed by a table.
    Or, enter a term into the Search box to quickly navigate to the file.

  6. To use this file for lookup purposes, select the Lookup file checkbox. See Using lookup to learn more.

  7. Click Refresh to view the columns. 

  8. Specify whether the file is a Dimension or Fact.

  9. If the source data contains primary key or foreign key, the system automatically marks it.

  10. When you choose to view the Column List, you can sort, filter, and set Column Properties as needed. See the rest of this topic to learn more.

  11. Choose Preview Table to see sample data and set up a filter. See the rest of this topic to learn more.

  12. Click Save when you are finished. You can click Revert if needed.

image-20241126-064459.png

For Azure SQL DB Connection

If you are working with Azure SQL database connection, select an appropriate column to define the Spark partitions. A partition column enables distributed data reading during the cube build based on a range of values of the selected column. The column data type should be either number or date. For example, choose the column which is used as distribution key and sort key. Choosing an appropriate partition column greatly impacts the cube build time.
If you don't choose a partition column, Kyvos automatically chooses the first number column and uses it to define how Spark partitioning should be performed.

Panel
panelIconIdatlassian-note
panelIcon:note:
bgColor#DEEBFF

Note

In Azure SQL Database, make sure that the fact tables with high data volume should have partitioning on the table column which is used in the Partition column option of the Kyvos register file.

Aura tab
summaryHCatalog
paramsJTdCJTIydGl0bGUlMjIlM0ElMjJIQ2F0YWxvZyUyMiU3RA==
  1. From the Toolbox, click Files.

  2. Click the Actions menu (  ), choose Add File.

  3. Select the Connection from the list.

  4. Set Input Type to Table.

  5. Select the HCatalog database followed by a table.
    Or, enter a term into the Search box to quickly navigate to the file.

  6. To use this file for lookup purposes, select the Lookup file checkbox. See Using lookup to learn more.

  7. Click Refresh to view the columns. 

  8. Specify whether the file is a Dimension or Fact.

  9. If the source data contains primary key or foreign key, the system automatically marks it.

  10. When you choose to view the Column List, you can sort, filter, and set Column Properties as needed. See the rest of this topic to learn more.

  11. Choose Preview Table to see sample data and set up a filter. See the rest of this topic to learn more.

  12. Click Save when you are finished. You can click Revert if needed.

...