Procedura: rinominare oggetti di database

In questo argomento viene illustrato come rinominare un oggetto di database in Visual Studio Premium. Quando si rinomina un oggetto di database, vengono aggiornati automaticamente con il nuovo nome anche gli altri oggetti che fanno riferimento all'oggetto rinominato. Se ad esempio si rinomina una colonna di una tabella, eventuali stored procedure che fanno riferimento a tale colonna verranno aggiornate automaticamente con il nuovo nome. Per ulteriori informazioni, vedere Ridenominazione di tutti i riferimenti a un oggetto di database.

Per rinominare un oggetto di database

  1. Nella finestra Visualizzazione schema fare clic sull'oggetto che si desidera rinominare. Per rinominare una colonna, ad esempio, espandere la sottocartella Tabelle, la tabella, quindi la cartella Colonne e fare clic sull'oggetto da rinominare.

    Nota

    In Visual Studio Premium si utilizza il refactoring degli oggetti di database mediante la finestra Visualizzazione schema. Non è possibile effettuare il refactoring di oggetti di database da una finestra del codice.

  2. Scegliere Effettua refactoring dal menu Dati e quindi Rinomina. È inoltre possibile fare clic con il pulsante destro del mouse sull'oggetto nella finestra Visualizzazione schema, scegliere Effettua refactoring e quindi Rinomina.

    Verrà visualizzata la finestra di dialogo Rinomina.

    Nota

    Non è possibile rinominare un oggetto di database se tale oggetto contiene errori di compilazione. In questo caso, l'opzione di menu non è disponibile.

  3. In Nuovo nome digitare il nuovo nome dell'oggetto.

  4. (Facoltativo) Selezionare la casella di controllo Anteprima modifiche.

    Nota

    Per informazioni su come visualizzare in anteprima le modifiche prima di applicarle, vedere la procedura successiva. Per impostazioni predefinita, i riferimenti negli unit test e negli script non vengono aggiornati automaticamente. È necessario utilizzare la finestra di dialogo Anteprima modifiche per applicare tali modifiche.

  5. (Facoltativo) Selezionare la casella di controllo Schema di progetto predefinito dbo per script non qualificato e riferimenti a unit test.

    Se la casella di controllo è deselezionata e non si specificano nomi completi negli script e negli unit test, tali riferimenti non verranno trovati. Se la casella di controllo è selezionata e non si specificano nomi completi negli script e negli unit test, si presupporrà che lo schema predefinito per tali oggetti corrisponda a quello predefinito del progetto.

  6. (Facoltativo) Selezionare la casella di controllo Aggiorna i riferimenti negli oggetti dello schema che contengono avvisi o errori.

    Se questa casella di controllo è deselezionata, i riferimenti all'interno di oggetti le cui definizioni comportano avvisi o errori non saranno inclusi nell'operazione di refactoring. Se la casella di controllo è selezionata, tutti i riferimenti saranno aggiornati, anche se la definizione dell'oggetto contenitore include avvisi o errori.

    Nota

    Se si rinomina un oggetto di database quando nel progetto sono presenti errori di compilazione, l'oggetto potrà comunque essere rinominato correttamente. Non tutti i riferimenti a tale oggetto, tuttavia, potranno essere aggiornati in modo corretto. Se il progetto contiene errori di compilazione, l'oggetto verrà rinominato e verrà aggiornato il numero più elevato possibile di riferimenti. È inoltre possibile correggere prima gli errori di compilazione e, successivamente, eseguire l'operazione di ridenominazione. Per ulteriori informazioni, vedere Considerazioni prima della ridenominazione di oggetti di database.

  7. Scegliere OK.

    Se è stata selezionata la casella di controllo Anteprima modifiche, verrà visualizzata la finestra di dialogo Anteprima modifiche. In caso contrario, verranno applicate le modifiche. Il nome dell'oggetto verrà aggiornato e il nuovo nome verrà visualizzato in Visualizzazione schema.

    Nota

    È possibile annullare le modifiche. Per ulteriori informazioni, vedere Procedura: Annullare un'operazione di refactoring del database.

    Oltre ai file di log facoltativi indicati nel passaggio 6, ogni volta che si sposta un oggetto di database in uno schema diverso, vengono scritte voci nel file NomeProgetto.refactorlog. Questo file fa parte del progetto di database e viene utilizzato quando si distribuisce il progetto di database. È necessario archiviarlo nel controllo della versione e gestire il file come qualsiasi altra risorsa di progetto condivisa. Per ulteriori informazioni, vedere Spostamento di un oggetto di database in un altro schema.

Per visualizzare l'anteprima delle modifiche prima di apportarle

  1. Nella finestra di dialogo Rinomina digitare il nuovo nome dell'oggetto.

  2. Selezionare la casella di controllo Anteprima modifiche e scegliere OK.

    Verrà visualizzata la finestra di dialogo Anteprima modifiche composta da un riquadro superiore e da un riquadro inferiore. Nel riquadro superiore è presente una struttura ad albero in cui sono elencati gli oggetti che verranno modificati, mentre nel riquadro inferiore è visualizzato lo script che verrà generato per apportare le modifiche. Nel riquadro superiore viene visualizzato il nome precedente, mentre in quello inferiore il nuovo nome.

  3. Nel riquadro superiore espandere Oggetti dello schema.

    Verrà visualizzato un nodo sql per l'oggetto dello schema che viene rinominato, o per l'oggetto che lo contiene, insieme ai nodi sql per tutti gli oggetti dello schema che fanno riferimento all'oggetto rinominato.

  4. Scegliere uno dei nodi sql.

    Nel riquadro inferiore verrà visualizzato il codice Transact-SQL con il nuovo nome evidenziato.

  5. Scegliere Applica.

    Verranno applicate le modifiche. Il nome dell'oggetto verrà aggiornato e il nuovo nome verrà visualizzato nella finestra Visualizzazione schema.

    Nota

    È possibile annullare le modifiche. Per ulteriori informazioni, vedere la classe Procedura: Annullare un'operazione di refactoring del database.

Vedere anche

Attività

Procedura dettagliata: applicare tecniche di refactoring del database

Procedura: distribuire le modifiche del refactoring del database

Concetti

Ridenominazione di tutti i riferimenti a un oggetto di database