data-governance semantic-type import

qlik data-governance semantic-type import

Import semantic types

Synopsis

Imports semantic types from a JSON file. Supports Qlik Cloud format (QlikSemanticTypesExport) and Talend legacy format (DQDictionaryImportExport). Format is auto-detected from the exportFormat field in the payload.

Conflict handling is controlled by the skipConfirmation flag and the optional conflictResolutions array:

  • Preview (skipConfirmation false/absent, no conflictResolutions): the file is analysed but nothing is imported. Returns 200 with a per-type conflict/summary body. Re-submit with skipConfirmation=true or conflictResolutions to actually apply the import.

  • One-shot (skipConfirmation=true, no conflictResolutions): if real conflicts or in-file duplicates exist, returns 200 with the conflict body and imports nothing; otherwise the import is applied and 201 is returned with the import report.

  • Resolved (conflictResolutions provided): the import is applied using the per-label strategies, falling back to defaultConflictStrategy (defaults to SKIP) for unlisted labels. Returns 201 in both cases (conflicts present or not), with the import report.

Import is best-effort: each type is processed independently. Failures are logged in the response report without blocking other types.

qlik data-governance semantic-type import [flags]

Options 

      --conflictResolutions-label string      Label of the conflicting semantic type.
      --conflictResolutions-strategy string   ˋOVERWRITEˋ: replace the existing type with the version from the file. ˋSKIPˋ: keep the existing type unchanged, do not import. ˋKEEP_BOTHˋ: keep the existing type and create the version from the file with a deduplicated label.
                                              Allowed values: "OVERWRITE", "SKIP", "KEEP_BOTH"
      --defaultConflictStrategy string        Fallback strategy applied to conflicting types not listed in ˋconflictResolutionsˋ. Defaults to ˋSKIPˋ.
                                              Allowed values: "OVERWRITE", "SKIP", "KEEP_BOTH"
      --file unknown                          (Required) The export file payload as-is. Format is detected from the ˋexportFormatˋ field. Accepts ˋQlikSemanticTypesExportˋ (Qlik native) or ˋDQDictionaryImportExportˋ (Talend legacy).
  -h, --help                                  help for import
      --interval int                          Duration in seconds to wait between retries, at least 1 (default 1)
  -q, --quiet                                 Return only IDs from the command
      --raw                                   Return original response from server without any processing
      --retry int                             Number of retries to do before failing, max 10
      --skipConfirmation                      Controls preview vs. one-shot import when no ˋconflictResolutionsˋ are supplied. When ˋfalseˋ (default) the call is a **preview**: the file is analysed and a per-type conflict/summary body is returned (HTTP 200) without importing anything. When ˋtrueˋ the import is attempted **one-shot**: if real conflicts or in-file duplicates exist the conflict body is returned (HTTP 200) and nothing is imported; otherwise all types are imported (HTTP 201). Ignored when ˋconflictResolutionsˋ are provided (those always apply the import).

Options inherited from parent commands 

  -c, --config string            path/to/config.yml where parameters can be set instead of on the command line
      --context string           Name of the context used when connecting to Qlik Associative Engine
      --headers stringToString   HTTP headers to use when connecting to Qlik Associative Engine (default [])
      --insecure                 Allow connecting to hosts with self-signed certificates
      --json                     Returns output in JSON format, if possible. Disables verbose and traffic output
  -s, --server string            URL to Qlik Cloud or directly to a Qlik Associative Engine
      --server-type string       The type of server you are using: cloud, Windows (Enterprise on Windows) or engine
  -v, --verbose                  Log extra information
Was this page helpful?