Démo
———–
Soit les tables suivantes :

T_CHAR (col1 CHAR (X)) et T_VARCHAR (col1 VARCHAR (X))

X est la longueur maximale définit pour chaque type.

Le nombre d’octets pour une colonne T_CHAR (col1) est égal à : X
Le nombre moyen d’octets pour une colonne T_VARCHAR (col1) est égal à : X/2 + 2

Pour quelles valeurs de X la colonne T_CHAR(col1) permet de gagner plus d’espace de stockage que la colonne T_VARCHAR(col1) ?

La traduction mathématique de cette question peut s’écrire de la façon suivante :

X < X/2 + 2

Résolvons cette inéquation

Cela veut dire que si la colonne est variable et que le nombre de caractères est majoritairement inférieur ou égal à 4,
il est plus bénéfique d’utiliser le type CHAR

Ici un autre billet de SQLPro relatif à la question CHAR ou VARCHAR ?

————————————————————————————
— Auteur : Etienne ZINZINDOHOUE
————————————————————————————

CREATE TABLE customer

(

cust_id smallint NULL,

cust_name varchar(50) NULL,

cust_addr1 varchar(50) NULL,

cust_addr2 varchar(50) NULL,

cust_city varchar(50) NULL,

cust_state char(2) NULL,

cust_postal_code varchar(10) NULL,

cust_phone varchar(20) NULL,

cust_fax varchar(20) NULL,

cust_email varchar(30) NULL,

cust_web_url varchar(100) NULL

)

Avec 1000 lignes dans la table voici le résultat fournit par POWER AMC 9.5

–POWER AMC 9.5

Estimation de la taille de la base de donnes "ModeleConceptuelDonnees_1"…

Nombre Taille estime Objet

————————- ———————– —————————————————-

1.000 405 Ko Table "customer"

————————- ———————– —————————————————-

405 Ko Espace total estimé

Nous allons maintenant utiliser la procédure de Tim Laqua. cette procédure est détaillée ici

–> La table de définition des types : les types Geography et Geometry ne sont pas pris en compte

CREATE TYPE TableColumnDefinition AS TABLE
  ([DataType] VARCHAR(16) NOT NULL
  ,[Length] INT
  ,[IsKey] BIT
  ,[DataLength] AS
    CASE  
      WHEN [DataType] = 'BIT' THEN 0.125
      WHEN [DataType] = 'TINYINT' THEN 1
      WHEN [DataType] = 'SMALLINT' THEN 2
      WHEN [DataType] IN ('INT', 'SMALLMONEY', 'REAL', 'SMALLDATETIME') THEN 4
      WHEN [DataType] IN ('BIGINT', 'DATETIME', 'MONEY') THEN 8
      WHEN [DataType] = 'UNIQUEIDENTIFIER' THEN 16
      WHEN [DataType] = 'NVARCHAR' THEN [Length] * 2 + 2
      WHEN [DataType] = 'VARCHAR' THEN [Length] + 2  -- DOESN'T SUPPORT MAX
      WHEN [Datatype] = 'DATE' THEN 3  
      WHEN [Datatype] = 'TIME' THEN 5 -- Worst case
      WHEN [Datatype] = 'DATETIME2' THEN 8 -- Worst case
      WHEN [Datatype] = 'DATETIMEOFFSET' THEN 10 -- Worst case
      WHEN [DataType] = 'CHAR' THEN [Length]
      WHEN [DataType] = 'NCHAR' THEN [Length] * 2 + 2
      WHEN [DataType] = 'BINARY' THEN [Length]
      WHEN [DataType] = 'VARBINARY' THEN [Length] + 2
      WHEN [Datatype] = 'TIMESTAMP' THEN 8
      WHEN [DataType] = 'XML' THEN [Length]  -- Estimate an average size in bytes, 2GB max
      WHEN [DataType] IN ('DECIMAL', 'NUMERIC') THEN  
        CASE  
          WHEN [Length] BETWEEN 1 AND 9  THEN 5
          WHEN [Length] BETWEEN 10 AND 19 THEN 9
          WHEN [Length] BETWEEN 20 AND 28 THEN 13
          WHEN [Length] BETWEEN 29 AND 38 THEN 17
        END
      WHEN [DataType] = 'FLOAT' THEN
        CASE
          WHEN [Length] BETWEEN 1 AND 24 THEN 4
          WHEN [Length] BETWEEN 25 AND 53 THEN 8
          WHEN [Length] IS NULL THEN 8  -- Default n is 53
        END
      ELSE 0
    END
  ,[IsVariableLength] AS
    CASE  
      WHEN [DataType] IN ('VARCHAR', 'NVARCHAR', 'VARBINARY') THEN 1
      ELSE 0
    END)

–> La procédure stockée de calcul

/*************************************************************************************
***
*** Procedure:      [Utility_EstimateClusteredIndexSize]
*** Purpose:        Estimates the amount of space needed for a given clustered index
*** Methodology:    http://msdn.microsoft.com/en-us/library/ms178085.aspx
***      
***      
*** Author:          Tim Laqua
*** Date Created:    2009-10-15  
***  
*** Revision History
*** Date    Author      Description
*** 2009-10-15  tl        Created
*************************************************************************************/
ALTER PROCEDURE [dbo].[Utility_EstimateClusteredIndexSize]
(
   @Num_Rows FLOAT
  ,@ClusteredIndexIsUnique BIT
  ,@Fill_Factor FLOAT
  ,@TableColumn TableColumnDefinition READONLY
)
AS  
 
SET NOCOUNT ON
 
DECLARE
   @Num_Cols FLOAT = 0          -- total number of columns (fixed-length and variable-length)
  ,@Fixed_Data_Size FLOAT = 0      -- total byte size of all fixed-length columns
  ,@Num_Variable_Cols FLOAT  = 0      -- number of variable-length columns
  ,@Max_Var_Size FLOAT  = 0        -- maximum byte size of all variable-length columns
  ,@Variable_Data_Size FLOAT = 0
 
DECLARE @VAR TABLE
  ([Name] VARCHAR(64)
  ,[VALUE] FLOAT
  ,[DisplayValue] AS
    CASE
      WHEN LOWER([Name]) LIKE '%size%' OR LOWER([Name]) LIKE '%space%' THEN
        CASE  
          WHEN [VALUE] < 1024 THEN CAST(CAST(ROUND([VALUE], 3) AS NUMERIC(16,0)) AS VARCHAR(16)) + ' B'
          WHEN [VALUE] < 1024*1024 THEN CAST(CAST(ROUND([VALUE]/1024, 3) AS NUMERIC(16,3)) AS VARCHAR(16)) + ' KB'
          WHEN [VALUE] < 1024*1024*1024 THEN CAST(CAST(ROUND([VALUE]/1024/1024, 3) AS NUMERIC(16,3)) AS VARCHAR(16)) + ' MB'
          ELSE CAST(CAST(ROUND([VALUE]/1024/1024/1024, 3) AS NUMERIC(16,3)) AS VARCHAR(16)) + ' GB'
        END
      ELSE CAST(FLOOR([VALUE]) AS VARCHAR(16))
    END)
 
 
-- Leaf level data
SELECT  
   @Num_Variable_Cols = COUNT(1)
  ,@Max_Var_Size = ISNULL(SUM([DataLength]), 0)
FROM @TableColumn WHERE [IsVariableLength] = 1
 
SELECT  
   @Num_Cols = COUNT(1) + @Num_Variable_Cols
  ,@Fixed_Data_Size = CEILING(ISNULL(SUM([DataLength]), 0))
FROM @TableColumn WHERE [IsVariableLength] = 0
 
 
INSERT INTO @VAR VALUES ('@Fixed_Data_Size', @Fixed_Data_Size)
 
IF @ClusteredIndexIsUnique <> 0
BEGIN
  SET @Num_Cols += 1
  IF @Num_Variable_Cols > 0
    SET @Num_Variable_Cols += 1
  IF @Max_Var_Size > 0
    SET @Max_Var_Size += 4
END
 
DECLARE @Null_Bitmap INT = CEILING(2 + ((@Num_Cols + 7) / 8))
INSERT INTO @VAR VALUES ('@Null_Bitmap', @Null_Bitmap)
 
-- if there are variable columns
IF @Num_Variable_Cols > 0
  SET @Variable_Data_Size = 2 + (@Num_Variable_Cols * 2) + @Max_Var_Size  
INSERT INTO @VAR VALUES ('@Num_Cols', @Num_Cols)
INSERT INTO @VAR VALUES ('@Num_Variable_Cols', @Num_Variable_Cols)
INSERT INTO @VAR VALUES ('@Max_Var_Size', @Max_Var_Size)
 
DECLARE @Row_Size FLOAT = CEILING(@Fixed_Data_Size + @Variable_Data_Size + @Null_Bitmap + 4 )
INSERT INTO @VAR VALUES ('@Row_Size', @Row_Size)
 
DECLARE @Rows_Per_Page FLOAT = FLOOR(8096 / (@Row_Size + 2))
INSERT INTO @VAR VALUES ('@Rows_Per_Page', @Rows_Per_Page)
 
DECLARE @Free_Rows_Per_Page FLOAT = FLOOR(8096 * ((100 - @Fill_Factor) / 100) / (@Row_Size + 2) )
INSERT INTO @VAR VALUES ('@Free_Rows_Per_Page', @Free_Rows_Per_Page)
 
DECLARE @Num_Leaf_Pages FLOAT = CEILING(@Num_Rows / (@Rows_Per_Page - @Free_Rows_Per_Page) )
INSERT INTO @VAR VALUES ('@Num_Leaf_Pages', @Num_Leaf_Pages)
 
DECLARE @Leaf_space_used FLOAT = 8192 * @Num_Leaf_Pages
INSERT INTO @VAR VALUES ('@Leaf_space_used', @Leaf_space_used)
 
-- Index Information
DECLARE
   @Num_Key_Cols FLOAT = 0      -- total number of key columns (fixed-length and variable-length)
  ,@Fixed_Key_Size FLOAT = 0      -- total byte size of all fixed-length key columns
  ,@Num_Variable_Key_Cols FLOAT = 0  -- number of variable-length key columns
  ,@Max_Var_Key_Size FLOAT = 0    -- maximum byte size of all variable-length key columns
 
 
SELECT  
   @Num_Variable_Key_Cols = COUNT(1)
  ,@Max_Var_Key_Size = ISNULL(SUM([DataLength]), 0)
FROM @TableColumn  
WHERE  
  [IsVariableLength] = 1  
  AND [IsKey] = 1
 
SELECT  
   @Num_Key_Cols = COUNT(1) + @Num_Variable_Key_Cols
  ,@Fixed_Key_Size = ISNULL(SUM([DataLength]), 0)
FROM @TableColumn  
WHERE  
  [IsVariableLength] = 0
  AND [IsKey] = 1
 
IF @ClusteredIndexIsUnique <> 0
BEGIN
  SET @Num_Key_Cols += 1
  IF @Num_Variable_Key_Cols > 0
    SET @Num_Variable_Key_Cols += 1
  IF @Max_Var_Key_Size > 0
    SET @Max_Var_Key_Size += 4
END
INSERT INTO @VAR VALUES ('@Num_Variable_Key_Cols', @Num_Variable_Key_Cols)
INSERT INTO @VAR VALUES ('@Max_Var_Key_Size', @Max_Var_Key_Size)
INSERT INTO @VAR VALUES ('@Num_Key_Cols', @Num_Key_Cols)
 
-- Who would seriously have a nullable key column?  ridiculous.
DECLARE @Index_Null_Bitmap FLOAT = 2 + ((@Num_Key_Cols + 7) / 8)  
INSERT INTO @VAR VALUES ('@Index_Null_Bitmap', @Index_Null_Bitmap)
 
DECLARE @Variable_Key_Size FLOAT = 0
 
IF @Max_Var_Key_Size > 0
  SET @Variable_Key_Size = 2 + (@Num_Variable_Key_Cols * 2) + @Max_Var_Key_Size  
INSERT INTO @VAR VALUES ('@Variable_Key_Size', @Variable_Key_Size)
 
DECLARE @Index_Row_Size FLOAT = @Fixed_Key_Size + @Variable_Key_Size + @Index_Null_Bitmap + 1 + 6
INSERT INTO @VAR VALUES ('@Index_Row_Size',@Index_Row_Size )
 
DECLARE @Index_Rows_Per_Page  FLOAT = FLOOR(8096 / (@Index_Row_Size + 2))
INSERT INTO @VAR VALUES ('@Index_Rows_Per_Page', @Index_Rows_Per_Page)
 
DECLARE @Non_Leaf_Levels FLOAT = 1
 
-- Log base @Non_Leaf_Levels hack
WHILE (@Num_Leaf_Pages / @Index_Rows_Per_Page) > POWER(@Index_Rows_Per_Page,@Non_Leaf_Levels)
  SET @Non_Leaf_Levels += 1
 
SET @Non_Leaf_Levels += 1
INSERT INTO @VAR VALUES ('@Non_Leaf_Levels', @Non_Leaf_Levels)
 
-- Summation hack
DECLARE  
   @Num_Index_Pages FLOAT = 0
  ,@Summand INT = @Non_Leaf_Levels
 
WHILE @Summand > 0
BEGIN
  SET @Num_Index_Pages += CEILING(@Num_Leaf_Pages/POWER(@Index_Rows_Per_Page, @Summand))
  SET @Summand -= 1
END
INSERT INTO @VAR VALUES ('@Num_Index_Pages', @Num_Index_Pages)
 
DECLARE @Index_Space_Used FLOAT = 8192 * @Num_Index_Pages  
INSERT INTO @VAR VALUES ('@Index_Space_Used', @Index_Space_Used)
 
DECLARE @Clustered_Index_Size FLOAT = @Leaf_Space_Used + @Index_Space_used
INSERT INTO @VAR VALUES ('@Clustered_Index_Size', @Clustered_Index_Size)
 
SELECT * FROM @VAR

–> Test de la procédure en utilisant la définition (DDL) de la table customer

DECLARE @TableColumn TableColumnDefinition

INSERT INTO @TableColumn

VALUES

('smallint',NULL,0)

,('VARCHAR',50,0)

,('VARCHAR',50,0)

,('VARCHAR',50,0)

,('VARCHAR',50,0)

,('CHAR',2,0)

,('VARCHAR',10,0)

,('VARCHAR',20,0)

,('VARCHAR',20,0)

,('VARCHAR',30,0)

,('VARCHAR',100,0)

EXEC [dbo].[Utility_EstimateClusteredIndexSize]

@Num_Rows = 1 – number of rows in the table

,@ClusteredIndexIsUnique = 0 – is it?

,@Fill_Factor = 90 – page fill factor

,@TableColumn = @TableColumn – definition of table columns

Résultat

——————————

@Row_Size 431 octets

@Rows_Per_Page 18

Pour les 1000 lignes, l'estimation de la taille de la base = 431 octets X 1000 = 421 Ko

–> Que peut-on dire ?

POWER AMC estime la taille de la base à 405 Ko et la procédure basée sur la méthodologie Microsoft affiche 421 Ko. à mon humble avis ces résultats sont proches.

Qu’en pensez-vous ?

————————————————————————-
Auteur : Etienne ZINZINDOHOUE
————————————————————————-

/*===========================================================================================

– Procdure Stocke permettant d'afficher les cls trangres(FK) relatives une cl primaire (PK)

– SQL SERVER 2005/2008 – Version1

– Auteur : Etienne ZINZINDOHOUE

—————— Exemple d'utilisation ———————————————–

P_Affiche_Liens_PK_FK_sql2005_2008 @schemaName = N'HumanResources', @tableName = N'Employee'

–===========================================================================================*/

USE AdventureWorks

go

CREATE PROCEDURE P_Affiche_Liens_PK_FK_sql2005_2008

@schemaName VARCHAR(50),@tableName VARCHAR(50)

AS

DECLARE @pk VARCHAR(max),@fk VARCHAR(max)

DECLARE @maTableVar table (

PKTABLE_QUALIFIER sysname

,PKTABLE_OWNER sysname

,PKTABLE_NAME sysname

,PKCOLUMN_NAME sysname

,FKTABLE_QUALIFIER sysname

,FKTABLE_OWNER sysname

,FKTABLE_NAME sysname

,FKCOLUMN_NAME sysname

,KEY_SEQ smallint

,UPDATE_RULE smallint

,DELETE_RULE smallint

,FK_NAME sysname

,PK_NAME sysname

,DEFERRABILITY smallint)

INSERT INTO @maTableVar

EXEC ('EXEC sp_fkeys @pktable_name = N'''+@tableName +''', @pktable_owner = N'''+@schemaName +'''');

SELECT PKTABLE_QUALIFIER+ '.'+ PKTABLE_OWNER + '.' +PKTABLE_NAME AS [Base.Schema.Table_Parent]

,PKCOLUMN_NAME AS [PK]

,FKTABLE_QUALIFIER + '.' + FKTABLE_OWNER + '.' + FKTABLE_NAME AS [Base.Schema.Table_Enfant]

,FKCOLUMN_NAME AS [FK]

FROM @maTableVar

ORDER BY [Base.Schema.Table_Parent],[PK],[Base.Schema.Table_Enfant],[FK]

GO

/*===========================================================================================

– Procdure Stocke permettant d'afficher les cls trangres(FK) relatives une cl primaire (PK)

– SQL SERVER 2000 – Version1

– Auteur : Etienne ZINZINDOHOUE

—————— Exemple d'utilisation ———————————————–

EXEC P_Affiche_Liens_PK_FK_sql2000 @schemaName = N'dbo',@tableName = N'Employees'

===========================================================================================*/

USE Northwind

GO

CREATE PROCEDURE P_Affiche_Liens_PK_FK_sql2000

@schemaName VARCHAR(50),@tableName VARCHAR(50)

AS

SELECT t1.TABLE_CATALOG +'.'+t1.TABLE_SCHEMA + '.'+ t1.TABLE_NAME AS [Base.Schema.Table_Parent]

,c1.name AS [PK]

,t2.TABLE_CATALOG +'.'+t2.TABLE_SCHEMA + '.'+ t2.TABLE_NAME AS [Base.Schema.Table_Enfant]

,c2.name AS [FK]

FROM sysforeignkeys f

INNER JOIN syscolumns c1 ON f.rkeyid = c1.id AND f.rkey = c1.colid

INNER JOIN syscolumns c2 ON f.fkeyid = c2.id AND f.fkey = c2.colid

INNER JOIN INFORMATION_SCHEMA.TABLES t1 ON t1.TABLE_NAME = object_name(f.rkeyid)

INNER JOIN INFORMATION_SCHEMA.TABLES t2 ON t2.TABLE_NAME = object_name(f.fkeyid)

WHERE object_name(f.rkeyid) = + @tableName + ' ' AND t1.TABLE_SCHEMA = + @schemaName

ORDER BY [Base.Schema.Table_Parent],[PK],[Base.Schema.Table_Enfant],[FK]

GO

=============================================================
Pour une purge saine [je parle des données ;-)]
=============================================================

Ces procédures stockées peuvent être utiles par exemple lors de la mis en place de batch de purge. Une des principales étapes de la mise en place de la purge d’une base de données est d’identifier les liens PK-FK entre tables. Ceci afin d’éviter les lignes orphelines (dans les « tables Enfant »). La conséquence logique de cette précaution est d’assurer la consistance et la qualité des données dans la base, lorsque l’option ON DELETE CASCADE n’est pas implémentée.

——————————————————————
— Etienne ZINZINDOHOUE
——————————————————————

——————————————————–

–> SQL 2005/2008 : Afficher les tables sans PK sans FK :

——————————————————–

SELECT DB_NAME() + '.' + object_schema_name(t.object_id) + '.' + t.name AS [Tables sans PK sans FK]

FROM sys.tables t

WHERE OBJECTPROPERTY(object_id, 'IsPrimaryKey') = 0

AND OBJECTPROPERTY(object_id, 'TableHasPrimaryKey') = 0

AND OBJECTPROPERTY(object_id, 'IsForeignKey') = 0

AND OBJECTPROPERTY(object_id, 'TableHasForeignKey') = 0

AND OBJECTPROPERTY(object_id, 'TableHasForeignRef') = 0

AND OBJECTPROPERTY(object_id, 'IsUserTable') = 1

ORDER BY [Tables sans PK sans FK]

——————————————————–

–> SQL 2000 : Afficher les tables sans PK sans FK

——————————————————–

SELECT t.TABLE_CATALOG + '.' + t.TABLE_SCHEMA + '.' + t.TABLE_NAME AS [Tables sans PK sans FK]

FROM INFORMATION_SCHEMA.tables t

WHERE OBJECTPROPERTY(OBJECT_ID(TABLE_NAME), 'IsPrimaryKey') = 0

AND OBJECTPROPERTY(OBJECT_ID(TABLE_NAME), 'TableHasPrimaryKey') = 0

AND OBJECTPROPERTY(OBJECT_ID(TABLE_NAME), 'IsForeignKey') = 0

AND OBJECTPROPERTY(OBJECT_ID(TABLE_NAME), 'TableHasForeignKey') = 0

AND OBJECTPROPERTY(OBJECT_ID(TABLE_NAME), 'TableHasForeignRef') = 0

AND OBJECTPROPERTY(OBJECT_ID(TABLE_NAME), 'IsUserTable') = 1

ORDER BY [Tables sans PK sans FK]

/*===========================================================================================

–> PROCEDURES STOCKEES

– Procdure Stocke permettant d'afficher les tables sans cl primaire(PK)

– SQL SERVER 2005-2008

– Version1

– Auteur : Etienne ZINZINDOHOUE

—————— Exemple d'utilisation ———————————————–

EXEC usp_AfficheTableSansPK_2005_2008 @InstanceName = N'MONSERVEUR\MONINSTANCE', @BaseName = N'AdventureWorks'

—————————————————————————————–

===========================================================================================*/

/***************************** PRE-REQUIS **********************************************

Pour utiliser la procdure 'sp_primarykeys' il faut configurer l'option DATA ACCESS; du serveur

En excutant la commande suivante :

EXEC sp_serveroption 'MONSERVEUR\MONINSTANCE', 'data access', 'true'

Si non lors de l'excution de la procdure vous aurez le message d'erreur :

——————————————————————

Msg 7411, Level 16, State 1, Procedure sp_primarykeys, Line 10

Server 'MONSERVEUR\MONINSTANCE' is not configured for DATA ACCESS.

——————————————————————

–OU En franais

——————————————————————

Msg 7411, Level 16, State 1, Procedure sp_primarykeys, Line 10

Le serveur 'MONSERVEUR\MONINSTANCE' n'est pas configur pour DATA ACCESS.

——————————————————————

****************************************************************************************/

CREATE PROCEDURE usp_AfficheTableSansPK_2005_2008

@InstanceName VARCHAR(50),@BaseName VARCHAR(50)

AS

BEGIN

SET NOCOUNT ON

DECLARE @maTableVar table (

TABLE_CAT sysname

,TABLE_SCHEM sysname

,TABLE_NAME sysname

,COLUMN_NAME sysname

,KEY_SEQ int

,PK_NAME sysname NULL

)

INSERT INTO @maTableVar

EXEC ('EXEC sp_primarykeys @table_server = N'''+@InstanceName +''', @table_catalog = N'''+@BaseName +'''');

SELECT t.TABLE_CATALOG + '.' + t.TABLE_SCHEMA +'.'+ t.TABLE_NAME AS [Base.Schema.Table]

FROM INFORMATION_SCHEMA.TABLES t

WHERE t.TABLE_CATALOG = + @BaseName AND TABLE_TYPE = 'BASE TABLE'

EXCEPT

SELECT DISTINCT TABLE_CAT + '.' + TABLE_SCHEM +'.'+ TABLE_NAME AS [Base.Schema.Table]

FROM @maTableVar

END

————————————————————————————
–> Discussion associée
————————————————————————————

http://www.developpez.net/forums/d1003616/bases-donnees/ms-sql-server/administration/table-pk-sgbdr-permissif-pourquoi/

————————————————————————————
Etienne ZINZINDOHOUE
————————————————————————————

De façon générale, une clause WHERE SARGable est sous la forme :

• Colonne  opérateur  <constante ou variable>
• <constante ou variable>  opérateur Colonne

avec comme opérateur l’une des valeurs suivantes :

=, >, <, >=, <=, IN, BETWEEN et parfois LIKE (dans les cas des concordances des préfixes, tels que LIKE 'etie%')

Est donc Non-SARG un WHERE contenant comme opérateur l’une des valeurs suivantes :

NOT, <>, NOT EXISTS, NOT IN, NOT LIKE (LIKE '%nne' ou LIKE '%tie%')

Remarque :
===========
/!\ Le comportement de l’opérateur LIKE varie en fonction de la version SQL SERVER et de l’édition

Pour la démo nous allons utiliser le jeu de données suivant :

–Création de la table de test T_TEST
–============================================================

–Chargement d’un million de lignes dans la table : Cette opération a duré environ 9 minutes sur ma machine (SQL2K8 Edition Entreprise (version Evaluation) – OS: WXP SP3 – 2CPU T5600 @1.83GHZ – Mémoire = 2Go )
–============================================================

– Ce qu’il faut savoir concernant le plan d’exécution des requêtes
–============================================================
• « Table Scan » indique la lecture complète de la table donc pas d’index utilisé

• « Index Scan » indique que la table est analysée à travers l’index, cela ne veut pas dire que l’index est utilisé pour accéder directement aux lignes individuelles. Autrement dit la requête ne profite pas de l’indexe, c’est un opérateur similaire à « table scan ».

• « Index Seek » indique que l’optimiseur utilise l’index à bon escient, utilisation correcte de l’index par le moteur

–> Conseil N° 1 : Éviter l’usage des opérateurs Non-SARG dans la clause WHERE
–============================================================

–> Démo : Conseil N° 1
— ===============================================================================

–Résultat : le plan d’exécution montre un Index Scan => la requête ne profite pas de l’indexe

–> Conseil N° 2 : Éviter l’usage des opérations arithmétiques sur les colonnes dans la clause WHERE
–============================================================

–> Démo : Conseil N° 2
— ===============================================================================

–Résultat : le plan d’exécution montre un Index Scan => la requête ne profite pas de l’indexe

–> Conseil N° 3 : Éviter l’usage des fonctions sur les colonnes dans la clause WHERE
–============================================================

–> Démo : Conseil N° 3
— ===============================================================================

–Résultat : le plan d’exécution montre un Index Scan => la requête ne profite pas de l’indexe

Alors que la même requête sans la fonction convert sur la colonne id utilise bien l’indexe créé => présence de l’Index Seek

Autre exemple avec les fonctions horodatages

— Supprimons l’index placé sur la colonne ID de la table T_TEST
DROP INDEX IX_ID ON dbo.T_TEST

–Créons un index clustered sur la colonne « creation_date »
CREATE CLUSTERED INDEX IX_creationdate ON dbo.T_TEST(creation_date)

–Vérifions le bon usage de l’indexe crée

–Résultat : Présence d’Index Seek => Bonne utilisation de l’index crée

Appliquons maintenant des fonctions sur la colonne date

–Résultat : le plan d’exécution montre un Index Scan => la requête ne profite pas de l’indexe

On peut bien sûr rendre SARGable la requête précédente en l’écrivant autrement.

–Résultat : Présence d’Index Seek => Bonne utilisation de l’index crée

–> Conseil N° 4 : Éviter d’avoir WHERE Table1.colonne1 opérateur Table1.colonne2 (colonne1 et colonne2 appartiennent à la même table)
–============================================================

–> Démo : Conseil N° 4
— ===============================================================================

–Résultat : le plan d’exécution montre un Index Scan => la requête ne profite pas de l’indexe
–Remarque : dans notre cas la colonnes id (int) et val (varchar) ne sont pas typées pareil. Et pourtant la requête s’exécute sans erreur. Ceci parce que l’optimiseur a fait une conversion implicite. Il faut a tout prix éviter ce genre de chose c’est à dire respecter les types de données car ceci a d’impact sur la performance de la requête.
Pour notre Démo, si les colonnes id et val sont du même type on a également un Index Scan.

–> Conseil N° 5 : Éviter d’avoir dans la clause WHERE Non-SARG OR SARG
–============================================================

–> Démo : Conseil N° 5
— ===============================================================================

–Résultat : le plan d’exécution montre un Index Scan => la requête ne profite pas de l’indexe

Par contre un WHERE Non-SARG AND SARG peut être SARGable
Voici un exemple

–> Conseil N° 6 : N’oublier pas les exceptions suivantes :
–============================================================

Fonction ISNULL
===============================
— Supprimons tous les index précédents [pour être sûr qu’il y a rien qui traine ;-)]

–Créons un index sur la colonne id
CREATE CLUSTERED INDEX IX_ID ON dbo.T_TEST(id)

–Exécutons la requête

–Résultat : Présence d’Index Seek => Bonne utilisation de l’index crée malgré l’application de la fonction ISNULL à la colonne id !

Fonction IS NULL
===============================
–Supprimons l’index IX_ID
DROP INDEX IX_ID ON dbo.T_TEST

–Créons l’index sur la colonne val
CREATE CLUSTERED INDEX IX_VAL ON dbo.T_TEST(val)

— Exécutons la requête

–Résultat : Présence d’Index Seek => Bonne utilisation de l’index crée !

Fonction IS NOT NULL
===============================
Comme précédemment on a il y a utilisation de l’index pour la requête

–> L’opérateur « IN » est-il SARGable ?
–============================================================

–Supprimons tous les indexes créés précédement

— Créons à nouveau l’indexe sur la colonne val
CREATE CLUSTERED INDEX IX_VAL ON dbo.T_TEST(val)

— Testons la requête suivante :

–Résultat : Présence d’Index Seek => Bonne utilisation de l’index crée !

On voit donc dans cet exemple que l’opérateur IN est SARGable dans les conditions de notre test (SQL 2008 version Entreprise)

–> L’opérateur « OR » est-il SARGable ?
–============================================================

–Gardons toujours l’index IX_VAL précédemment crée puis examinons la requête suivante

–Résultat : Présence d’Index Seek => Bonne utilisation de l’index crée !

On voit donc dans cet exemple que l’opérateur OR est SARGable dans les conditions de notre test (SQL 2008 version Entreprise)

===========================================================================================================================
Il y a encore beaucoup de choses à dire sur l’optimisation des requêtes, là c’est juste une petite analyse sous le prisme de la clause WHERE. On peut également analyser les clauses JOIN ,HAVING , condition de trie ORDER BY et les fonctions d’aggrégations.

===========================================================================================================================
Vos commentaires sont les bienvenus

voici le script de création de ces tables :

1. ) Erreur générée lors du DELETE aveugle dans la table HumanResources.Department
Quand on exécute directement la commande :

On a cette erreur :
L’instruction DELETE est en conflit avec la contrainte REFERENCE « FK_EmployeeDepartmentHistory_Department_DepartmentID ».
Le conflit s’est produit dans la base de données « AdventureWorks », table « HumanResources.EmployeeDepartmentHistory », column ‘DepartmentID’.
L’instruction a été arrêtée.

2. ) La solution revient à faire d’abord le DELETE approprié dans la table ENFANT HumanResources.EmployeeDepartmentHistory avant la suppression dans la table PARENT HumanResources.Department

Voici le script T-SQL pour cette opération :

BEGIN TRANSACTION
 
--> DELETE DE LA TABLE ENFANT  
DELETE FROM HumanResources.EmployeeDepartmentHistory  
WHERE  HumanResources.EmployeeDepartmentHistory.DepartmentID
IN  
(SELECT Department.DepartmentID
FROM HumanResources.Department Department INNER JOIN HumanResources.EmployeeDepartmentHistory EmployeeDepartmentHistory  
                                           ON Department.DepartmentID = EmployeeDepartmentHistory.DepartmentID
WHERE Department.GroupName = 'Research and Development'
)
--> DELETE TABLE PARENT      
DELETE FROM HumanResources.Department
WHERE GroupName = 'Research and Development'
 
COMMIT

*********************************************************
Auteur : Etienne ZINZINDOHOUE
*********************************************************

-->Initialisation des mesures <br />
SET NOCOUNT ON <br />
DECLARE @cpu_timedebut INT <br />
DECLARE @logical_reads_debut INT <br />
BEGIN <br />
DBCC DROPCLEANBUFFERS <br />
DBCC FREEPROCCACHE <br />
DBCC FREESYSTEMCACHE ('ALL') <br />
SELECT @cpu_timedebut = cpu_time       -- Temps CPU (en millisecondes) utilisé par la demande <br />
, @logical_reads_debut = logical_reads -- Nombre de lectures logiques effectuées par la demande <br />
FROM sys.dm_exec_requests <br />
WHERE session_id = @@spid  <br />
 <br />
-->====== Début de l'instrustion à mesurer  ====== <br />
..... <br />
..... <br />
..... <br />
-->====== Fin de l'instrustion à mesurer  ======  <br />
 <br />
-->Afficher les mesures <br />
SELECT cpu_time - @cpu_timedebut AS [Temps CPU (ms)]  <br />
, logical_reads - @logical_reads_debut AS [Nb Lectures Logiques] <br />
FROM sys.dm_exec_requests <br />
WHERE session_id = @@spid ;

Préparation : Configuration de ma machine de test
=========================================================================================

Nom du système d’exploitation : Microsoft Windows XP Professionnel
Version du système : 5.1.2600 Service Pack 3 version 2600
Processeur(s): 1 processeur(s) installé(s).[01]: x86 Family 6 Model 15 Stepping 6 GenuineIntel ~1828 MHz
Mémoire physique totale : 2 046 Mo

Mesure pour le curseur
=========================================================================================
Scénario : afficher toutes les bases de données de mon instance dont le nom commence par AdventureWorks. Dans mon cas j’ai la liste suivante qui s’affiche :
AdventureWorks
AdventureWorksDW
AdventureWorksLT
AdventureWorksLT2008

/******************************************************************************************** <br />
DESCRIPTION : Utilisation du CURSEUR pour afficher toutes les bases de données de mon instance dont le nom commence par AdventureWorks.  <br />
Auteur : Etienne ZINZINDOHOUE <br />
*********************************************************************************************/ <br />
--Initialisation des mesures <br />
SET NOCOUNT ON <br />
DECLARE @cpu_timedebut INT <br />
DECLARE @logical_reads_debut INT <br />
BEGIN <br />
DBCC DROPCLEANBUFFERS <br />
DBCC FREEPROCCACHE <br />
DBCC FREESYSTEMCACHE ('ALL') <br />
 <br />
SELECT @cpu_timedebut = cpu_time       -- Temps CPU (en millisecondes) utilisé par l'instrustion <br />
, @logical_reads_debut = logical_reads -- Nombre de lectures logiques effectuées par l'instrustion <br />
FROM sys.dm_exec_requests <br />
WHERE session_id = @@spid  <br />
 <br />
--====== DEBUT DE L'INSTRUSTION  ====== <br />
DECLARE @BaseEnCoursTraitement VARCHAR(50); <br />
DECLARE baseATraiter_cursor CURSOR STATIC LOCAL FORWARD_ONLY FOR <br />
SELECT [name] AS [NomBase] <br />
FROM sys.databases <br />
WHERE [name] LIKE 'AdventureWorks%' <br />
ORDER BY [NomBase] <br />
 <br />
OPEN baseATraiter_cursor <br />
FETCH NEXT FROM baseATraiter_cursor INTO @BaseEnCoursTraitement <br />
WHILE @@FETCH_STATUS = 0 <br />
BEGIN <br />
PRINT @BaseEnCoursTraitement <br />
-- Au suivant <br />
FETCH NEXT FROM baseATraiter_cursor INTO @BaseEnCoursTraitement <br />
END <br />
CLOSE baseATraiter_cursor <br />
DEALLOCATE baseATraiter_cursor <br />
--====== FIN DE L'INSTRUSTION ====== <br />
--Afficher les mesures <br />
SELECT cpu_time - @cpu_timedebut AS [Temps CPU (ms)]  <br />
, logical_reads - @logical_reads_debut AS [Nb Lectures Logiques] <br />
FROM sys.dm_exec_requests <br />
WHERE session_id = @@spid ; <br />
END  <br />

Mesure pour le SELECT TOP 1 … DELETE
=========================================================================================

 <br />
/***************************************************************************************** <br />
DESCRIPTION : Utilisation du SELECT TOP 1 ... DELETE pour afficher toutes les bases de données de mon instance dont le nom commence par AdventureWorks.  <br />
Auteur : Etienne ZINZINDOHOUE  <br />
*****************************************************************************************/ <br />
--Initialisation des mesures <br />
SET NOCOUNT ON <br />
DECLARE @cpu_timedebut INT <br />
DECLARE @logical_reads_debut INT <br />
BEGIN <br />
DBCC DROPCLEANBUFFERS <br />
DBCC FREEPROCCACHE <br />
DBCC FREESYSTEMCACHE ('ALL') <br />
 <br />
SELECT @cpu_timedebut = cpu_time       -- Temps CPU (en millisecondes) utilisé par la demande <br />
, @logical_reads_debut = logical_reads -- Nombre de lectures logiques effectuées par la demande <br />
FROM sys.dm_exec_requests <br />
WHERE session_id = @@spid  <br />
 <br />
--====== DEBUT DE L'INSTRUSTION  ====== <br />
DECLARE @BaseEnCoursTraitement VARCHAR(50),@SQL VARCHAR (max), @DEL VARCHAR (max)  <br />
CREATE TABLE #LISTE_BASES (nom_base varchar (50))  <br />
INSERT INTO #LISTE_BASES   <br />
SELECT [name] AS [NomBase]  <br />
FROM sys.databases  <br />
WHERE [name] LIKE 'AdventureWorks%' <br />
ORDER BY [NomBase]  <br />
-- Tant qu'il y a des lignes dans la table temporaire  <br />
WHILE EXISTS ( SELECT nom_base  <br />
  FROM #LISTE_BASES  <br />
  )   <br />
BEGIN  <br />
--Se positionner sur la 1ère ligne de la table temporaire  <br />
SET @BaseEnCoursTraitement = (SELECT TOP 1 nom_base FROM #LISTE_BASES)  <br />
-- Appliquer le Niveau de compatibilité SQL 2005  <br />
PRINT @BaseEnCoursTraitement <br />
-- Supprimer la base traitée de la table temporaire  <br />
SET @DEL = 'DELETE FROM #LISTE_BASES WHERE nom_base = '''+ @BaseEnCoursTraitement + ''';'  <br />
EXEC (@DEL)  <br />
END  <br />
--Supprimer la table temporaire  <br />
DROP TABLE #LISTE_BASES   <br />
--====== FIN DE L'INSTRUSTION ====== <br />
--Afficher les mesures <br />
SELECT cpu_time - @cpu_timedebut AS [Temps CPU (ms)]  <br />
, logical_reads - @logical_reads_debut AS [Nb Lectures Logiques] <br />
FROM sys.dm_exec_requests <br />
WHERE session_id = @@spid ; <br />
END

Résultats
=========================================================================================

–#### 1er Essai ###

–> Avec Le curseur
Temps CPU (ms) Nb Lectures Logiques
0 85

–> Avec Le SELECT TOP 1 …DELETE
Temps CPU (ms) Nb Lectures Logiques
47 477

–#### 2ème Essai ###

–> Avec Le curseur
Temps CPU (ms) Nb Lectures Logiques
0 85

–> Avec Le SELECT TOP 1 …DELETE
Temps CPU (ms) Nb Lectures Logiques
78 471

–#### 3ème Essai ###

–> Avec Le curseur
Temps CPU (ms) Nb Lectures Logiques
0 85

–> Avec Le SELECT TOP 1 …DELETE
Temps CPU (ms) Nb Lectures Logiques
47 472

Pour les 3 essais le constat est que : le CURSEUR est plus performant que mes SELECT TOP 1 … DELETE

0.) Configurer votre poste de façon à pouvoir exécuter un script Powershell.
J’ai écrit un petit billet pour ça ICI

1.) Créer un fichier contenant les informations d’accès aux serveurs

Ce fichier contenant la liste des serveurs nommée : listeserveurs.txt a la structure suivante :

AdresseIP,Domaine\Login,Password,NomInstance

AdresseIP = Adresse IP (ou nom) du serveur de base de données
Domaine = Domaine
Login = login
Password = mot de passe
NomInstance = Nom de l’instance de la base de données à monitorer.
Valeur par défaut default pour monitorer l’instance par défaut et NomInstance pour monitorer une instance nommée NomInstance

Exemple de fichier listeserveurs.txt :

IP0,Domaine0\Login0,Password0,default
IP1,Domaine1\Login1,Password1,NomInstance1
IP2,Domaine2\Login2,Password2,NomInstance2

2.) Script de monitoring des principaux services : Moteur SQL et Agent SQL

################ Monitoring ##########################################################################
#Lire le contenu du fichier contenant les infos des serveurs
$listserveurs = get-content "listeserveurs.txt"
#Traiter chaque ligne du fichier
foreach ($ligne in $listserveurs) {
   # Découpage de la ligne  
   $decoupageligne = $ligne.split(",")
   # Nom du serveur  
   $serveur = $decoupageligne[0]
   # le login pour ce serveur  
   $login =   $decoupageligne[1]
   # le password du serveur  
   $stringpwd = $decoupageligne[2]
   $pwd = convertto-securestring $stringpwd -asplaintext -force;
   # Construire la chaine d'authentification
   $credential = new-object -typename System.Management.Automation.PSCredential -argumentlist $login,$pwd -ErrorAction "silentlycontinue";
   # Instance à traiter  
   $instance = $decoupageligne[3]
   
   
# Pingé le serveur courant
$resultatsPing = Get-WMIObject -query "select StatusCode from Win32_PingStatus where Address = '$serveur'"
$reponse = $false
ForEach($resultat in $resultatsPing) {
  if ($resultatsPing.statuscode -eq 0) {
        $reponse = $true
  }
  }  
  if ($reponse) {
  # le serveur courant répond au ping
  Write-Host -foregroundcolor "green" ****************************************************************************************************
  Write-Host -foregroundcolor "green" Ping Serveur $serveur  ---  OK  
  Write-Host -foregroundcolor "green" ****************************************************************************************************
     
  ######## ETATS DES SERVICES ############
  if ($instance -eq 'default'){
    Write-Host ------------------------------------------------------
  Write-Host  SERVEUR -- $serveur INSTANCE  -- $instance
  Write-Host ------------------------------------------------------  
    $instancetraitemoteurdefault = 'MSSQLSERVER'
    $instancetraiteagentdefault = 'SQLSERVERAGENT'
    #Pour le moteur SQL
    $statemoteursqldefault = Get-WMIObject -query "select state from win32_service where name = '$instancetraitemoteurdefault'" -computername $serveur -credential $credential  
       if ($statemoteursqldefault.state -eq 'Running'){
         Write-Host -foregroundcolor "green" Serveur $serveur -- Moteur SQL $instancetraitemoteurdefault -- Démarré  
        Get-WMIObject win32_service -filter "name ='$instancetraitemoteurdefault'"  -computername $serveur -credential $credential  | format-table -property displayname,state,StartMode,status
      }else
      {Write-Host -foregroundcolor "red" Serveur $serveur -- Moteur SQL  $instancetraitemoteurdefault -- Arrêté  
      Get-WMIObject win32_service -filter "name ='$instancetraitemoteurdefault'"  -computername $serveur -credential $credential  | format-table -property displayname,state,StartMode,status
      }
     
    #Pour l'agent SQL
    $stateagentsqldefault = Get-WMIObject -query "select state from win32_service where name = '$instancetraiteagentdefault'" -computername $serveur -credential $credential  
       if ($stateagentsqldefault.state -eq 'Running'){
         Write-Host -foregroundcolor "green" Serveur $serveur -- Agent SQL $instancetraiteagentdefault -- Démarré  
        Get-WMIObject win32_service -filter "name ='$instancetraiteagentdefault'"  -computername $serveur -credential $credential  | format-table -property displayname,state,StartMode,status
      }else
      {Write-Host -foregroundcolor "red" Serveur $serveur -- Agent SQL $instancetraiteagentdefault -- Arrêté  
      Get-WMIObject win32_service -filter "name ='$instancetraiteagentdefault'"  -computername $serveur -credential $credential  | format-table -property displayname,state,StartMode,status
      }
           
     
    }
    else{
    #Traitement des instances nommées
    Write-Host ------------------------------------------------------
  Write-Host  SERVEUR -- $serveur INSTANCE  -- $instance
  Write-Host ------------------------------------------------------  
    $instancetraitemoteur = 'MSSQL$'+$instance
    $instancetraiteagent = 'SQLAgent$'+$instance    
    #Pour le moteur SQL
    $statemoteursql = Get-WMIObject -query "select state from win32_service where name = '$instancetraitemoteur'" -computername $serveur -credential $credential  
       if ($statemoteursql.state -eq 'Running'){
         Write-Host -foregroundcolor "green" Serveur $serveur -- Moteur SQL $instancetraitemoteur -- Démarré  
        Get-WMIObject win32_service -filter "name ='$instancetraitemoteur'"  -computername $serveur -credential $credential  | format-table -property displayname,state,StartMode,status
      }else
      {Write-Host -foregroundcolor "red" Serveur $serveur -- Moteur SQL  $instancetraitemoteur -- Arrêté  
      Get-WMIObject win32_service -filter "name ='$instancetraitemoteur'"  -computername $serveur -credential $credential  | format-table -property displayname,state,StartMode,status
      }
       
     #Pourl'agent SQL
     $stateagent = Get-WMIObject -query "select state from win32_service where name = '$instancetraiteagent'" -computername $serveur -credential $credential  
       if ($stateagent.state -eq 'Running'){
         Write-Host -foregroundcolor "green" Serveur $serveur -- Agent SQL   $instancetraiteagent -- Démarré  
        Get-WMIObject win32_service -filter "name ='$instancetraiteagent'"  -computername $serveur -credential $credential  | format-table -property displayname,state,StartMode,status
      }else
      {Write-Host -foregroundcolor "red" Serveur $serveur -- Agent SQL  $instancetraiteagent -- Arrêté  
      Get-WMIObject win32_service -filter "name ='$instancetraiteagent'"  -computername $serveur -credential $credential  | format-table -property displayname,state,StartMode,status
      }
     
    }
   }
 
  else {
  # le serveur courant ne répond au ping
        Write-Host -foregroundcolor "red" Le Serveur $serveur ne répond pas /!\ -- KO
  Write-Host -foregroundcolor "red" Ping Serveur $serveur -- KO
  }
}

3.) Résultat

****************************************************************************************************
Ping Serveur IP0 — OK
****************************************************************************************************
——————————————————
SERVEUR IP0 INSTANCE — default
——————————————————
Serveur IP0 Moteur SQL MSSQLSERVER — Démarré

displayname state StartMode status
———– —– ——— ——
MSSQLSERVER Running Auto OK

Serveur IP0 Agent SQL SQLSERVERAGENT — Démarré

displayname state StartMode status
———– —– ——— ——
SQLSERVERAGENT Running Auto OK

….

Remarque : il faut trouver un moyen de sécuriser le fichier contenant des logins et password. par exemple le crypté

/*****************************************************************************
— MONITORING DES SERVICES SQL DE TOUTES LES INSTANCES DE BASE DE DONNEES
— Auteur : Etienne ZINZINDOHOUE
*****************************************************************************/

Remarques :
1. ) Ce script ne marche que sous SQL 2000
Si vous essayer de l’exécuter sous SQL Server Management Studio (SSMS)2005 ou 2008, vous aurez une erreur du type :

Msg 213, Niveau 16, État 7, Ligne 1
Le nom ou le numéro de colonne des valeurs fournies ne correspond pas à la définition de la table.
Msg 3013, Niveau 16, État 1, Ligne 1
RESTORE HEADERONLY s’est terminé anormalement.

2.)
Vous ne pouvez pas utiliser ce script pour obtenir les infos d’un fichier backupé sous SQL 2005 ou SQL 2008.
Vous aurez dans ce cas une erreur du type :

Serveur : Msg 3205, Niveau 16, État 2, Ligne 1
Trop d’unités de sauvegarde spécifiées pour la sauvegarde ou la restauration. Seules 64 sont autorisées.
Serveur : Msg 3013, Niveau 16, État 1, Ligne 1
RESTORE HEADERONLY s’est terminé anormalement.

/**************************************************
— SQL 2000 – INFORMATIONS DU FICHIER BACKUP
— Auteur : Etienne ZINZINDOHOUE
*************************************************/

/***********************************************************
— Description : Modifier la colonne IDENTITY d’une table.
— Auteur : Etienne ZINZINDOHOUE
***********************************************************/
–Soit la table initiale avec une colonne autoincrément(1,1)

Pour des raisons X ou Y on peut être amener à modifier la
colonne
auto-incrément ID_USER (1,1) pour le mettre à ID_USER (2,2) par exemple.
On pourrait penser qu’un ALTER TABLE suffit à faire la modification. Mais Non…
Vous ne pouvez pas faire la modification avec la comande :

Vous aurez dans ce cas une erreur.

Alors qu’il bien possible de modifier par exemple la colonne LOGIN avec la même commande :

Alors comment modifier la colonne IDENTITY d’une table ?

Voici la solution :
–> 1.) Créer une table temporaire ayant la même structure que la table à modifier
–> 2.) Importer des données de la table initiale vers la table temporaire
–> 3.) Supprimer les clées primaires (PK) et étrangères (FK) de la table initiale
–> 4.) Renommer la table temporaire (nom de la table initiale à modifier)
–> 5.) Ajouter les clés primaires (PK) et étrangères (FK)

/***********************************************************
— Description : Modifier la colonne IDENTITY d’une table.
— Auteur : Etienne ZINZINDOHOUE
***********************************************************/