digna CLI-referens 2026.04¶

2026-04-08

Denna sida dokumenterar hela uppsättningen kommandon som finns i digna CLI-versionen 2026.04, inklusive användningsexempel och alternativ.

CLI-grunderna¶

help¶

Alternativet --help ger information om tillgängliga kommandon och hur de används. Det finns två huvud sätt att använda detta alternativ:

1. Visa allmän hjälp:

Använd --help omedelbart efter nyckelordet dignacli

dignacli --help

1. Hämta hjälp för specifika kommandon:

För detaljerad information om ett specifikt kommando, lägg till --help efter det kommandot.
Till exempel, för att få hjälp med kommandot add-user, kör:

dignacli add-user --help

### utdata:

• Kommandobeskrivning: Ger en detaljerad beskrivning av vad kommandot gör.
• Syntax: Visar exakt syntax, inklusive obligatoriska och valfria argument.
• Alternativ: Lista över alternativ som är specifika för kommandot, tillsammans med deras förklaringar.
• Exempel: Ger exempel på hur kommandot kan köras effektivt.

check-config¶

Kommandot check-config är ett verktyg i digna CLI som är avsett att testa konfigurationen av digna. Detta kommando säkerställer att digna-komponenterna kan hitta nödvändiga konfigurationselement i config.toml.

Alternativ¶

• --configpath, -cp: Fil eller katalog som innehåller konfigurationen. Om detta utelämnas används ../config.toml.

Kommandoanvändning¶

dignacli check-config

Vid lyckad körning skriver kommandot ut en bekräftelse på att konfigurationen är komplett.

Om konfigurationen verkar vara ofullständig kommer de saknade konfigurationselementen att listas.

check-repo-connection¶

Kommandot check-repo-connection är ett verktyg i digna CLI som är avsett att testa anslutning och åtkomst till ett angivet digna repository. Detta kommando säkerställer att CLI kan interagera med repositoryt.

Kommandoanvändning¶

dignacli check-repo-connection

Vid lyckad körning visar kommandot en bekräftelse av anslutningen, tillsammans med detaljer om repositoryt: Repository-version, Host, Database och Schema.

Om anslutningen till repositoryt inte lyckas, kontrollera config.toml-filen för korrekta konfigurationsinställningar.

version¶

För att kontrollera installerad version av dignacli används alternativet --version.

Kommandoanvändning¶

dignacli --version

Exempelutdata¶

dignacli version 2026.04

loggningsalternativ¶

Som standard är konsolutmatningen från digna-kommandon avsedd att vara minimalistisk. De flesta kommandon erbjuder möjlighet att ge ytterligare information med följande alternativ:

-- verbose (-v)
-- debug (-d)
-- logfile (lf)

”verbose” och ”debug” bestämmer detaljnivån, medan ”logfile”-omkopplaren tillåter att utmatningen dirigeras till en fil istället för till konsolfönstret.

Användarhantering¶

add-user¶

Kommandot add-user i digna CLI används för att lägga till en ny användare i digna-systemet.

Kommandoanvändning¶

dignacli add-user [OPTIONS] USER_NAME USER_FULL_NAME USER_PASSWORD

Argument¶

• USER_NAME: Användarnamn för den nya användaren (obligatoriskt).
• USER_FULL_NAME: Den nya användarens fullständiga namn (obligatoriskt).
• USER_PASSWORD: Lösenordet för den nya användaren (obligatoriskt).

Alternativ¶

• --is_superuser, -su: Flagga för att ange den nya användaren som administratör.
• --valid_until, -vu: Sätter ett utgångsdatum för användarkontot i formatet YYYY-MM-DD HH:MI:SS. Om det inte anges har kontot inget utgångsdatum.

Exempel¶

För att lägga till en ny användare med användarnamnet jdoe, fullständigt namn John Doe och lösenord password123:

dignacli add-user [OPTIONS] USER_NAME USER_FULL_NAME USER_PASSWORD

För att lägga till en ny användare och sätta ett utgångsdatum för kontot:

dignacli add-user jdoe "John Doe" password123 --valid_until "2024-12-31 23:59:59"

delete-user¶

Kommandot delete-user i digna CLI används för att ta bort en befintlig användare från digna-systemet.

Kommandoanvändning¶

dignacli delete-user USER_NAME

Argument¶

• USER_NAME: Användarnamnet för den användare som ska tas bort (obligatoriskt). Detta är det enda argumentet som krävs för kommandot.

Exempel¶

dignacli delete-user jdoe

Att köra detta kommando tar bort användaren jdoe från digna-systemet, återkallar deras åtkomst och raderar deras associerade data och behörigheter från repositoryt.

modify-user¶

Kommandot modify-user i digna CLI används för att uppdatera uppgifter för en befintlig användare i digna-systemet.

Kommandoanvändning¶

dignacli modify-user <USER_NAME> <USER_FULL_NAME> [options]

Argument¶

• USER_NAME: Användarnamnet för den användare som ska ändras (obligatoriskt).
• USER_FULL_NAME: Det nya fullständiga namnet för användaren (obligatoriskt).

Alternativ¶

• --is_superuser, -su: Sätter användaren som superuser och ger förhöjda privilegier. Denna flagga kräver inget värde.
• --valid_until, -vu: Sätter ett utgångsdatum för användarkontot i formatet YYYY-MM-DD HH:MI:SS. Om det inte anges förblir kontot giltigt tills vidare.

Exempel¶

För att ändra fullständigt namn för användaren jdoe till ”Johnathan Doe” och sätta användaren som superuser:

dignacli modify-user jdoe "Johnathan Doe" --is_superuser

modify-user-pwd¶

Kommandot modify-user-pwd i digna CLI används för att ändra lösenordet för en befintlig användare i digna-systemet.

Kommandoanvändning¶

dignacli modify-user-pwd <USER_NAME> <USER_PWD>

Argument¶

• USER_NAME: Användarnamnet för den användare vars lösenord ska ändras (obligatoriskt).
• USER_PWD: Det nya lösenordet för användaren (obligatoriskt).

Exempel¶

För att ändra lösenordet för användaren jdoe till newpassword123:

dignacli modify-user-pwd jdoe newpassword123

list-users¶

Kommandot list-users i digna CLI visar en lista över alla användare som är registrerade i digna-systemet.

Kommandoanvändning¶

dignacli list-users

Att köra detta kommando i digna CLI kommer att ansluta till digna-repositoryt och lista alla användare, visa deras ID, användarnamn, fullständiga namn, superuser-status och utgångstidsstämplar.

Repository-hantering¶

upgrade-repo¶

Kommandot upgrade-repo i digna CLI används för att uppgradera eller initiera digna-repositoryt. Detta kommando är nödvändigt för att tillämpa uppdateringar eller för att sätta upp repositoryinfrastrukturen för första gången.

Kommandoanvändning¶

dignacli upgrade-repo [options]

Alternativ¶

• --simulation-mode, -s: När detta är aktiverat körs kommandot i simuleringsläge, vilket skriver ut de SQL-satser som skulle köras men utför dem inte. Detta är användbart för att förhandsgranska ändringar utan att göra modifieringar i repositoryt.

Exempel¶

För att uppgradera digna-repositoryt kan du köra kommandot utan alternativ:

dignacli upgrade-repo

dignacli upgrade-repo --simulation-mode

Detta kommando är viktigt för att underhålla digna-systemet och säkerställa att databasens schema och andra repository-komponenter är uppdaterade med den senaste programvaruversionen.

encrypt¶

Kommandot encrypt i digna CLI används för att kryptera ett lösenord.

Kommandoanvändning¶

dignacli encrypt <PASSWORD>

Argument¶

• PASSWORD: Lösenordet som ska krypteras (obligatoriskt).

Exempel¶

För att kryptera ett lösenord måste du ange lösenordet som ett argument.
Till exempel, för att kryptera lösenordet mypassword123, skulle du använda:

dignacli encrypt mypassword123

generate-key¶

Kommandot generate-key används för att generera en Fernet-nyckel, vilket är nödvändigt för att säkra lösenord som lagras i digna-repositoryt.

Kommandoanvändning¶

dignacli generate-key

Datahantering¶

clean-up¶

Kommandot clean-up i digna CLI används för att ta bort profiler, prediktioner och data från trafikljussystemet för en eller flera datakällor inom ett angivet projekt. Detta kommando är viktigt för datahantering och hjälper till att hålla en organiserad och effektiv data-miljö genom att rensa föråldrad eller onödig data.

Kommandoanvändning¶

dignacli clean-up <PROJECT_NAME> <FROM_DATE> <TO_DATE> [options]

Argument¶

• PROJECT_NAME: Namnet på projektet där data ska tas bort (obligatoriskt). Om nyckelordet all-projects används som detta argument instrueras digna att iterera över alla befintliga projekt och tillämpa kommandot.
• FROM_DATE: Startdatum och -tid för datarensningen. Accepterade format inkluderar %Y-%m-%d, %Y-%m-%dT%H:%M:%S eller %Y-%m-%d %H:%M:%S (obligatoriskt).
• TO_DATE: Slutdatum och -tid för datarensningen, följande samma format som FROM_DATE (obligatoriskt).

Alternativ¶

• --table-name, -tn: Begränsar clean-up-operationen till en specifik tabell inom projektet.
• --table-filter, -tf: Filter för att begränsa clean-up till tabeller som innehåller den angivna delsträngen i sina namn.
• --timing, -tm: Visar tidsåtgången för clean-up-processen efter slutförandet.
• --help: Visar hjälpinformation för clean-up-kommandot och avslutar.

Exempel¶

För att ta bort data från projektet ProjectA mellan 1 januari 2023 och 30 juni 2023:

dignacli clean-up ProjectA 2023-01-01 2023-06-30

För att endast ta bort data från en specifik tabell som heter Table1:

dignacli clean-up ProjectA 2023-01-01 2023-06-30 --table-name Table1

Detta kommando hjälper till att hantera datalagring och säkerställer att repositoryt endast innehåller relevant information.

remove-orphans¶

Kommandot remove-orphans i digna CLI används för underhåll i digna-repositoryt.
När en användare tar bort projekt eller datakällor kan profiler och prediktioner bli kvar i repositoryt. Med detta kommando tas sådana föräldralösa (orphaned) rader bort från repositoryt.

Kommandoanvändning¶

dignacli list-projects

list-projects¶

Kommandot list-projects i digna CLI används för att visa en lista över alla tillgängliga projekt i digna-systemet.

Kommandoanvändning¶

dignacli list-projects

Detta kommando är särskilt användbart för administratörer och användare som hanterar flera projekt och ger en snabb överblick över de tillgängliga projekten i digna-repositoryt.

list-ds¶

Kommandot list-ds i digna CLI används för att visa en lista över alla tillgängliga datakällor inom ett angivet projekt. Detta kommando är användbart för att få en överblick över de dataresurser som finns för analys och hantering i digna-systemet.

Kommandoanvändning¶

dignacli list-ds <PROJECT_NAME>

Argument¶

• PROJECT_NAME: Namnet på projektet för vilket datakällorna listas (obligatoriskt).

Exempel¶

För att lista alla datakällor i projektet med namn ProjectA:

dignacli list-ds ProjectA

Detta kommando ger användare en översikt över de datakällor som finns i ett projekt och hjälper dem att navigera och hantera datalandskapet mer effektivt.

inspect¶

Kommandot inspect i digna CLI används för att skapa profiler, prediktioner och data för trafikljussystemet för en eller flera datakällor inom ett angivet projekt. Detta kommando hjälper till att analysera och övervaka data över en definierad period. Efter slutförd inspektion returneras värdet för det beräknade trafikljussystemet:
- 0: OK
- 1: INFO
- 2: WARNING

Kommandoanvändning¶

dignacli inspect <PROJECT_NAME> <FROM_DATE> <TO_DATE> [options]

Argument¶

• PROJECT_NAME: Namnet på projektet som ska inspekteras (obligatoriskt). Om nyckelordet all-projects används som detta argument instrueras digna att iterera över alla befintliga projekt och tillämpa kommandot.
• FROM_DATE: Startdatum och -tid för datainspektionen. Accepterade format inkluderar %Y-%m-%d, %Y-%m-%dT%H:%M:%S eller %Y-%m-%d %H:%M:%S (obligatoriskt).
• TO_DATE: Slutdatum och -tid för datainspektionen, följande samma format som FROM_DATE (obligatoriskt).

Alternativ¶

• --table-name, -tn: Begränsar inspektionen till en specifik tabell inom projektet.
• --table-filter, -tf: Filter för att endast inspektera tabeller som innehåller den angivna delsträngen i sina namn.
• --enable_notification, -en: Aktiverar utskick av notifikationer vid larm.
• --bypass-backend, -bb: Hoppa över backend och kör inspektionen direkt från CLI (endast för teständamål!).

Exempel¶

För att inspektera data för projektet ProjectA från 1 januari 2024 till 31 januari 2024:

dignacli inspect ProjectA 2024-01-01 2024-01-31

För att inspektera endast en specifik tabell och tvinga omberäkning av prediktioner:

dignacli inspect ProjectA 2024-01-01 2024-01-31 --table-name Table1 --force-prediction

inspect-async¶

Kommandot inspect-async i digna CLI används för att skapa profiler, prediktioner och data för trafikljussystemet för en eller flera datakällor inom ett angivet projekt. Detta kommando hjälper till att analysera och övervaka data över en definierad period. Till skillnad från kommandot inspect väntar detta inte på att inspektionen ska slutföras. Istället returnerar det request-id för den skickade inspektionsförfrågan. För att fråga efter status och framsteg i inspektionsprocessen används kommandot inspect-status.

Kommandoanvändning¶

dignacli inspect-async <PROJECT_NAME> <FROM_DATE> <TO_DATE> [options]

Argument¶

• PROJECT_NAME: Namnet på projektet som ska inspekteras (obligatoriskt). Om nyckelordet all-projects används som detta argument instrueras digna att iterera över alla befintliga projekt och tillämpa kommandot.
• FROM_DATE: Startdatum och -tid för datainspektionen. Accepterade format inkluderar %Y-%m-%d, %Y-%m-%dT%H:%M:%S eller %Y-%m-%d %H:%M:%S (obligatoriskt).
• TO_DATE: Slutdatum och -tid för datainspektionen, följande samma format som FROM_DATE (obligatoriskt).

Alternativ¶

• --table-name, -tn: Begränsar inspektionen till en specifik tabell inom projektet.
• --table-filter, -tf: Filter för att endast inspektera tabeller som innehåller den angivna delsträngen i sina namn.
• --enable_notification, -en: Aktiverar utskick av notifikationer vid larm.

Exempel¶

För att inspektera data för projektet ProjectA från 1 januari 2024 till 31 januari 2024:

dignacli inspect-async ProjectA 2024-01-01 2024-01-31

inspect-status¶

Kommandot inspect-status i digna CLI används för att kontrollera framstegen för en asynkron inspektion baserat på request-id.

Kommandoanvändning¶

dignacli inspect-status <REQUEST ID>

Argument¶

• REQUEST_ID: Request-id som returnerades av kommandot inspect-async

Exempel¶

För att kontrollera framstegen för en inspektion med request-id 12345:

dignacli inspect-status 12345

inspect-cancel¶

Kommandot inspect-cancel i digna CLI används för att avbryta inspektioner baserat på request-id eller för att avbryta alla pågående förfrågningar.

Kommandoanvändning¶

dignacli inspect-cancel <REQUEST ID>
dignacli inspect-cancel --killall

Argument¶

• REQUEST_ID: Request-id som returnerades av kommandot inspect-async

Exempel¶

För att avbryta inspektionen med request-id 12345:

dignacli inspect-cancel 12345

För att avbryta alla förfrågningar som för närvarande körs eller väntar:

dignacli inspect-cancel --killall

export-ds¶

Kommandot export-ds i digna CLI används för att skapa en export av datakällor från digna-repositoryt. Som standard exporteras alla datakällor från ett givet projekt.

Kommandoanvändning¶

dignacli export-ds <PROJECT_NAME> [options]

Argument¶

• PROJECT_NAME: Namnet på projektet från vilket datakällorna kommer att exporteras.

Alternativ¶

• --table_name, -tn: Exportera en viss datakälla från ett projekt.
• --exportfile, -ef: Ange filnamn för exporten.

Exempel¶

För att exportera alla datakällor från projektet med namn ProjectA:

dignacli export-ds ProjectA

Detta kommando exporterar alla datakällor från ProjectA som ett JSON-dokument som kan importeras till ett annat projekt eller digna-repository.

import-ds¶

Kommandot import-ds i digna CLI används för att importera datakällor till ett målsprojekt och skapa en importrapport.

Kommandoanvändning¶

dignacli import-ds <PROJECT_NAME> <EXPORT_FILE> [options]

Argument¶

• PROJECT_NAME: Namnet på projektet till vilket datakällorna kommer att importeras.
• EXPORT_FILE: Filnamnet för exportfilen som ska importeras.

Alternativ¶

• --output-file, -o: Fil för att spara importrapporten (om det inte anges skrivs den ut i terminalen i tabellform).
• --output-format, -f: Format för att spara importrapporten (json, csv).

Exempel¶

För att importera alla datakällor från exportfilen my_export.json till ProjectB:

dignacli import-ds ProjectB my_export.json

Efter importen visar detta kommando även en rapport över importerade och hoppade objekt. Endast nya datakällor kommer att importeras till ProjectB. För att ta reda på vilka objekt som skulle importeras och hoppas över kan du använda kommandot plan-import-ds

plan-import-ds¶

Kommandot plan-import-ds i digna CLI används för att analysera en exportfil och skapa en importplan och importrapport utan att faktiskt importera något.

Kommandoanvändning¶

dignacli plan-import-ds <PROJECT_NAME> <EXPORT_FILE> [options]

Argument¶

• PROJECT_NAME: Namnet på projektet till vilket datakällorna skulle importeras.
• EXPORT_FILE: Filnamnet för exportfilen som ska analyseras före import.

Alternativ¶

• --output-file, -o: Fil för att spara importrapporten (om det inte anges skrivs den ut i terminalen i tabellform).
• --output-format, -f: Format för att spara importrapporten (json, csv).

Exempel¶

För att kontrollera vilka datakällor som skulle importeras och vilka som skulle hoppas över från exportfilen my_export.json när den importeras till ProjectB:

dignacli plan-import-ds ProjectB my_export.json

Detta kommando visar endast en importplan över objekt som kommer att importeras och hoppas över.