24.1.2. Base de dados

24.1.2.1. Export to PostgreSQL

Exports a vector layer to a PostgreSQL database, creating a new relation. If a relation with the same name exists, it can be removed before the new relation is created. Prior to this a connection between QGIS and the PostgreSQL database has to be created (see eg Creating a stored Connection).

Parâmetros

Etiqueta	Nome	Tipo	Descrição
Layer to import	ENTRADA	[vector: any]	Vector layer to add to the database
Banco de dados (nome da conexão)	BANCO DE DADOS	[string]	Name of the database connection (not the database name). Existing connections will be shown in the combobox.
Esquema (nome do esquema) Opcional	ESQUEMA	[string] Padrão: ‘público’	Name of the schema to store the data. It can be a new one or already exist.
Table to import to (leave blank to use layer name) Opcional	TABLENAME	[string] Padrão: ‘’	Defines a table name for the imported vector file. If nothing is added, the layer name will be used.
Primary key field Opcional	PRIMARY_KEY	[tablefield: any]	Sets the primary key field from an existing field in the vector layer. A column with unique values can be used as Primary key for the database.
Geometry column	GEOMETRY_COLUMN	[string] Padrão: ‘geom’	Defines the name of the geometry column in the new PostGIS table. Geometry information for the features is stored in this column.
Encoding Opcional	ENCODING	[string] Default: ‘UTF-8’	Defines the encoding of the output layer
Overwrite	OVERWRITE	[boolean] Padrão: Verdadeiro	If the specified table exists, setting this option to True will make sure that it is deleted and a new table will be created before the features are added. If this option is False and the table exists, the algorithm will throw an exception (“relation already exists”).
Create spatial index	CREATEINDEX	[boolean] Padrão: Verdadeiro	Specifies whether to create a spatial index or not
Convert field names to lowercase	LOWERCASE_NAMES	[boolean] Padrão: Verdadeiro	Converts the field names of the input vector layer to lowercase
Drop length constraint on character fields	DROP_STRING_LENGTH	[boolean] Padrão: Falso	Should length constraints on character fields be dropped or not
Create single-part geometries instead of multi-part	FORCE_SINGLEPART	[boolean] Padrão: Falso	Should the features of the output layer be single-part instead of multi-part. By default the existing geometries information are preserved.

Saídas

The algorithm has no output.

Python code

Algorithm ID: qgis:importintopostgis

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.2.2. Export to SpatiaLite

Exports a vector layer to a SpatiaLite database. Prior to this a connection between QGIS and the SpatiaLite database has to be created (see eg Camadas SpatiaLite).

Parâmetros

Etiqueta	Nome	Tipo	Descrição
Layer to import	ENTRADA	[vector: any]	Vector layer to add to the database
File database	BANCO DE DADOS	[vector: any]	The SQLite/SpatiaLite database file to connect to
Table to import to (leave blank to use layer name) Opcional	TABLENAME	[string] Padrão: ‘’	Defines the table name for the imported vector file. If nothing is specified, the layer name will be used.
Primary key field Opcional	PRIMARY_KEY	[tablefield: any]	Use a field in the input vector layer as the primary key
Geometry column	GEOMETRY_COLUMN	[string] Padrão: ‘geom’	Defines the name of the geometry column in the new SpatiaLite table. Geometry information for the features is stored in this column.
Encoding Opcional	ENCODING	[string] Default: ‘UTF-8’	Defines the encoding of the output layer
Overwrite	OVERWRITE	[boolean] Padrão: Verdadeiro	If the specified table exists, setting this option to True will make sure that it is deleted and a new table will be created before the features of the layer is added. If this option is False and the table exists, the algorithm will throw an exception (“table already exists”).
Create spatial index	CREATEINDEX	[boolean] Padrão: Verdadeiro	Specifies whether to create a spatial index or not
Convert field names to lowercase	LOWERCASE_NAMES	[boolean] Padrão: Verdadeiro	Convert the field names of the input vector layer to lowercase
Drop length constraint on character fields	DROP_STRING_LENGTH	[boolean] Padrão: Falso	Should length constraints on character fields be dropped or not
Create single-part geometries instead of multi-part	FORCE_SINGLEPART	[boolean] Padrão: Falso	Should the features of the output layer be single-part instead of multi-part. By default the existing geometries information are preserved.

Saídas

The algorithm has no output.

Python code

Algorithm ID: qgis:importintospatialite

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.2.3. Package layers

Adds layers to a GeoPackage.

If the GeoPackage exists and Overwrite existing GeoPackage is checked, it will be overwritten (removed and recreated). If the GeoPackage exists and Overwrite existing GeoPackage is not checked, the layer will be appended.

Parâmetros

Etiqueta	Nome	Tipo	Descrição
Camadas de entrada	CAMADAS	[vector: any] [list]	The (vector) layers to import into the GeoPackage. Raster layers are not supported. If a raster layer is added, a QgsProcessingException will be thrown.
Overwrite existing GeoPackage	OVERWRITE	[boolean] Padrão: Falso	If the specified GeoPackage exists, setting this option to True will make sure that it is deleted and a new one will be created before the layers are added. If set to False, layers will be appended.
Save layer styles into GeoPackage	SAVE_STYLES	[boolean] Padrão: Verdadeiro	Save the layer styles
Destination GeoPackage	SAÍDA	[file] Default: [Save to temporary file]	Specify where to store the GeoPackage file. One of Save to a Temporary File Save to File…

Saídas

Etiqueta	Nome	Tipo	Descrição
Layers within new package	OUTPUT_LAYERS	[string] [list]	The list of layers added to the GeoPackage.

Python code

Algorithm ID: native:package

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.2.4. PostgreSQL execute and load SQL

Allows a SQL database query to be performed on a PostgreSQL database connected to QGIS and loads the result. The algorithm won’t create a new layer: it is designed to run queries on the layer itself.

Exemplo

1. Set all the values of an existing field to a fixed value. The SQL query string will be:

   UPDATE your_table SET field_to_update=20;
   

   In the example above, the values of the field field_to_update of the table your_table will be all set to 20.

2. Create a new area column and calculate the area of each feature with the ST_AREA PostGIS function.

   -- Create the new column "area" on the table your_table"
   ALTER TABLE your_table ADD COLUMN area double precision;
   -- Update the "area" column and calculate the area of each feature:
   UPDATE your_table SET area=ST_AREA(geom);
   

Ver também

PostgreSQL execute SQL, Executar SQL, SpatiaLite execute SQL

Parâmetros

Etiqueta	Nome	Tipo	Descrição
Banco de dados (nome da conexão)	BANCO DE DADOS	[string]	The database connection (not the database name). Existing connections will be shown in the combobox.
SQL query	SQL	[string]	Defines the SQL query, for example 'UPDATE my_table SET field=10'.
Unique ID field name	ID_FIELD	[string] Default: id	Sets the primary key field (a column in the result table)
Geometry field name Opcional	GEOMETRY_FIELD	[string] Padrão: ‘geom’	Name of the geometry column (a column in the result table)

Saídas

Etiqueta	Nome	Tipo	Descrição
SQL layer	SAÍDA	[vector: any]	The resulting vector layer to be loaded into QGIS.

Python code

Algorithm ID: qgis:postgisexecuteandloadsql

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.2.5. PostgreSQL execute SQL

Allows a SQL database query to be performed on a PostgreSQL database connected to QGIS. The algorithm won’t create a new layer: it is designed to run queries on the layer itself.

Exemplo

1. Set all the values of an existing field to a fixed value. The SQL query string will be:

   UPDATE your_table SET field_to_update=20;
   

   In the example above, the values of the field field_to_update of the table your_table will be all set to 20.

2. Create a new area column and calculate the area of each feature with the ST_AREA PostGIS function.

   -- Create the new column "area" on the table your_table"
   ALTER TABLE your_table ADD COLUMN area double precision;
   -- Update the "area" column and calculate the area of each feature:
   UPDATE your_table SET area=ST_AREA(geom);
   

Ver também

PostgreSQL execute and load SQL, Executar SQL, SpatiaLite execute SQL

Parâmetros

Etiqueta	Nome	Tipo	Descrição
Banco de dados (nome da conexão)	BANCO DE DADOS	[string]	The database connection (not the database name). Existing connections will be shown in the combobox.
SQL query	SQL	[string]	Defines the SQL query, for example 'UPDATE my_table SET field=10'.

Saídas

No output is created. The SQL query is executed in place.

Python code

Algorithm ID: native:postgisexecutesql

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.2.6. SpatiaLite execute SQL

Allows a SQL database query to be performed on a SpatiaLite database. The algorithm won’t create a new layer: it is designed to run queries on the layer itself.

Ver também

PostgreSQL execute SQL, Executar SQL

For some SQL query examples see PostGIS SQL Query Examples.

Parâmetros

Etiqueta	Nome	Tipo	Descrição
File Database	BANCO DE DADOS	[vector]	The SQLite/SpatiaLite database file to connect to
SQL query	SQL	[string] Padrão: ‘’	Defines the SQL query, for example 'UPDATE my_table SET field=10'.

Saídas

No output is created. The SQL query is executed in place.

Python code

Algorithm ID: native:spatialiteexecutesql

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.

24.1.2.7. SpatiaLite execute SQL (registered DB)

Allows a SQL database query to be performed on a SpatiaLite database connected to QGIS. The algorithm won’t create a new layer: it is designed to run queries on the layer itself.

Ver também

PostgreSQL execute SQL, Executar SQL

For some SQL query examples see PostGIS SQL Query Examples.

Parâmetros

Etiqueta	Nome	Tipo	Descrição
Database	BANCO DE DADOS	[enumeration] Default: not set	Select a SQLite/SpatiaLite database connected to the current session
SQL query	SQL	[string] Padrão: ‘’	Defines the SQL query, for example 'UPDATE my_table SET field=10'.

Saídas

No output is created. The SQL query is executed in place.

Python code

Algorithm ID: native:spatialiteexecutesqlregistered

import processing
processing.run("algorithm_id", {parameter_dictionary})

The algorithm id is displayed when you hover over the algorithm in the Processing Toolbox. The parameter dictionary provides the parameter NAMEs and values. See Usando os algoritmos do processamento a partir do Terminal Python. for details on how to run processing algorithms from the Python console.